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FOREWORD 


This  document  is  provided  by  the  Space  Information  Systems  Oper- 
ation (SISO)  in  accordance  with  the  requirements  of  Task  Order 
(TO)  P-6Q00  as  established  under  modification  No.  201  of  Contract 
NAS  9-1261 y Schedule  Vt  and  DRL  Line  Item  2.20. 

Parts  III  and  IV  of  this  document  will  be  forthcoming  under  sepa- 
rate covers  at  a later  date.  They  will  deal  with , respectively , 
the  program  operator's  guide , and  the  SEDS  program  listings. 
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SECTION  1 
INTRODUCTION 


1.1  SCREWWORM  ERADICATION  DATA  SYSTEM  (SEDS)  GENERAL  DESCRIPTION 

The  primary  purpose  of  this  system  is  to  convert  National  Oceanic 
and  Atmospheric  Administration  (NOAA)  satellite  data,  which  is  in 
analog  tape  form,  into  output  data  products.  These  products  are 
used  by  investigators  in  determining  optimum  areas  for  airdrops 
of  sterile  screwworm  flies  over  Mexico.  The  output  product  of 
SEDS  takes  the  form  of  imagery  data  film  slides  showing  Mexico 
and  the  lower  southwest  portion  of  the  United  States.  The  area 
covered  is  shown  by  the  reference  grid  in  figure  1-1. 

The  area  analog  preprocessing  phase  of  the  SEDS  task  is  covered 
in  Part  I of  this  series.  The  application  phase  processing  covered 
in  this  document  (Part  II)  starts  with  the  first  9-track  computer- 
compatible  tape  (CCT  of  the  NOAA  data.  Exclusive  of  the  prepro- 
cessing phase,  SEDS  is  composed  of  six  major  components  or  programs, 
which  are  pseudo- independent  in  that  each  is  a standalone  program, 
but  each'-  requires  input  and/or  output  data  from  the  others.  The 
four  SEDS  applications  programs  which  are  used  daily  during  pro- 
duction are  the  SEDS  Engineering  Unit  Conversion  Program  (SEU) , 
the  SEDS  Registration  Program  (SRE) , the  Rainfall  Algorithm  Pro- 
gram (RAP,  also  called  Data  Base  Update  Sequence  No.  1),  and  the 
Screwworm  Survival  Program  (SSP,  also  called  Data  Base  Update 
Sequence  No.  2) . The  other  two  major  programs  are  the  Display 
and  Product  Generator  (DPG)  and  Character  Density  Plot  (CDP)  Pro- 
grams; these  are  executed  on  as  as-needed  basis.  These  six  pro- 
grams are  described  in  Sections  2-7,  respectively. 

These  six  major  components  of  SEDS  are  further  linked  by  the 
System  Resident  Program,  described  in  paragraph  1.2.  Termination 
of  one  program,  return  to  the  system,  and  call-up  of  another  pro- 
gram is  done  without  program  reinitialization. 

The  SEDS  application  hardware  configuration  is  shown  by  figure  1-2. 
Except  for  system  initialization,  all  user  program  control  is  via 
the  VT05  display/keyboard.  The  user  displays  on  the  VT05  may  be 
hardcopied  out  to  the  line  printer  by  request  at  any  time.  For 
user  convenience  during  production,  remote  VT05  and  display  term- 
inals are  available  for  program  control  and  monitoring. 
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Figure  1-2  SEDS  Application  Hardware 
Configuration 
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The  independence  of  each  program  in  SEDS  is  due  to  the  function 
that  it  performs.  Data  from  the  NOAA  satellite  is  processed 
daily  through  SEDS.  Two  passes  per  day  are  processed  through  the 
registration  phase;  one  is  the  day  pass  with  both  visible  and  in- 
frared (IR)  channels,  and  the  other  is  the  night  pass  with  IR  data 
only.  The  day  IR  and  visible  data  and  night  IR  data  is  regis- 
tered, compressed  4-to-l  in  both  picture  element  (PIXEL)  and  scan 
directions,  and  made  disk-resident.  Compression  is  done  by  se- 
lecting every  fourth  PIXEL  of  every  fourth  scan  line,  thereby 
compressing  a 2500-PIXEL-by-2200-scan  registered  image  into  a 
62  5-PIXEL-by- 550-scan  "image.  Then  a single  run  is  made  through 
Data  Ease  Update  Sequences  No.  1 and  No.  2.  The  output  product 
tapes  suitable  for  film  processing  are  isothermal  day  and  night 
(OID/OIN) , rainfall  (ORC)  and  screwworm  (OWC) , as  shown  by  figure 
1-3.  These  image  maps  will  be  generated  using  false  color  assign- 
ments. ;j 

ft 

In  summary,  the  initial  digitized  tape  from  the  preprocessing 
phase  is  input  to  SEU  for  conversion  of  the  IR  data  from  engineer- 
ing units  (EU’s)  to  temperature  units.  The  visible  data  is  not 
converted.  The  output  tapes  of  SEU  serve  as  input  to  SRE,  which 
resections  the  data,  using  linear  remapping  coefficients,  and 
registers  it  to  the  SEDS  reference  grid.  When  both  day  and  night 
passes  have  been  processed  through  regis teration  and  the  data  is 
compressed  and  disk-resident,  the  two  data  base  update  sequences 
are  run.  Data  Base  Update  Sequence  No.  1 (RAP)  uses  the  registered 
day  IR  and  visible  data  on  disk  in  a two-channel  "maximum  likeli- 
hood" cloud  classifier  to  detect  cloud-contaminated  day  IR  data. 

It  then  uses  the  registered  day  and  night  IR  data  on  disk  from 
SRE , and  inputs  ground  truth  and  background  image  data  to  calcu- 
late a new  daily  mean  air  temperature  for  each  PIXEL.  The  output 
tape  from  RAP,  containing  daily  mean  air  temperature  (DMAT)  and 
crop  moisture  index  (CMI)  data,  serves  as  one  of  the  inputs  to 
Data  Update  Sequence  No.  2 (SSP) . During  data  base  initializa- 
tion, the  new  update  (SBC)  tape  is  the  only  input  to  SSP. [Each 
day’s  data  base  is  generated  and  output  to  the  new  data  base  (OBC) 
tape.  For  the  second  (and  subsequent)  day’s  processing,  the  pre- 
vious day's  data  base  is  input  as  the  old  OBC  tape.  The  data  in 
the  data  base  is  maintained  in  computational  form  as  means,  running 
averages,  and  accumulative  values.  The  data  base  update  is  ac- 
complished on  an  element-by-element  basis.  The  several  product 
images  relating  to  the  growth  potential  of  the  screwworm  fly  are 
output  to  the  screwworm  OWC  tape. 
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Figure  1-3  SEES  Data  Flow 
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Details  of  program  operations  ai-e  found  in  the  current  SBDS  Opera- 
tions Manual  (Part  III  of  this  series) . However,  SEDS  initiali- 
zation is  accomplished  through  input  via  card  reader  of  the  cards 
shown  by  figure  1-4,  The  initial  VT05  display  reflecting  system 
initialization  is  shown  by  figure  1-5. 

1.2  ABBREVIATIONS 

Letter  abbreviations  used  in  naming  tapes  described  in  this  docu- 
ment are  listed  in  table  1-1  for  easy  reference. 
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SRE  * SFDS  REGISTRATION  VERSION  01 
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Figure  1-5 


SEDS  Initial  VT05  Display 
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TABLE  1-1 

SEDS  TAPE  IDENTIFICATIONS 


LETTER  DESIGNATIONS 


B 

DATA  BASE  TAPE 

N 

NIGHT  PASS  TAPE 

C 

COMBINED  TAPE 

0 

OUTPUT  PRODUCT  TAPE 

D 

DAY  PASS  TAPE 

P 

PCM  TAPE 

E 

ENGINEERING  UNIT  TAPE 

R 

RAINFALL  TAPE 

I 

ISOTHERMAL  TAPE 

S 

UPDATE  (INTERMEDIATE)  TAPE 

M 

MAP  TAPE 

W 

SCREWWORM  TAPE 

TAPE  ID'S  AND  NAMES 


CM  I 

CROP  MOISTURE  INDEX 

SBC 

UPDATE 

CRT 

REGISTERED  INTERMEDIATE 

SED 

EU  DAY 

OBC 

DATA  BASE 

SEN 

EU  NIGHT 

OID 

ISOTHERMAL  DAY 

SMD 

REGISTERED  DAY 

OIN 

ISOTHERMAL  NIGHT 

SMN 

REGISTERED  NIGHT 

ORC 

RAINFALL 

SPD 

RAW  PCM  DAY 

owe 

SCREWWORM 

SPN 

RAW  PCM  NIGHT 
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1.3  SUDS  RESIDENT  PROGRAM 

1.3.1  General  Program  Characteristics.  The  principal  function 
of  this  software  is  process  control  of  the  six  major  application 
programs  in  SEDS  previously  mentioned.  The  SEDS  Resident  Program 
remains  in  core  from  system  initialization  to  termination.  It 
occupies  the  area  of  core  memory  between  disk  operating  system 
(DOS)  and  the  active  application  program  as  described  by  figure 
1-6.  The  functions  performed  by  this  program  are  program  initia- 
lization, name  recognition  of  the  application  program  as  requested 
by  the  user,  program  memory  mapping,  and  program  termination. 

The  SEDS  Resident  Program  is  composed  of  the  application  program 
controller,  system  routines  for  memory  overlay  and  segmentation, 
and  system  service  routines  for  interrupt  handling.  These  com- 
ponents are  linked  together  to  form  the  program  module  named 
SEDS.LDA.  This  is  the  portion  of  SEDS  which  gets  control  when 
the  card  deck,  shown  by  figure  1-4,  is  input  during  start  of  sys- 
tem initialization.  The  subcomponents  which  comprise  this  module 


consist  of  the  following: 

SEDS  CCTII*  NT  RAND 

GLOBLS  CCTII2*  NTRAND 

VTIN*  IDE11V*  CVP 

VTOIJT*  CCTCOM  SETEMT 

SPCMD*  SEGRES  FATAL 

VT0511*  SEGOUT  FTNLIB 


Those  subcomponents  marked  with  an  asterisk  are  newly  developed 
system  software  for  SEDS,  and  are  detailed  in  Section  8.  (Pait 
II)  of  this  specification.  The  remaining  software  components 
listed  above  consist  of  standard  DOS  software  or  software  previ- 
ously developed  by  SISO  for  the  PDP  11/45. 

1.3.2  Program  Flow  Chart.  See  eight  pages  following  figure  1-6 

1.3.3  Listings.  See  Part  IV  of  this  document  published  under 
separate  cover. 
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1.4  INITIALIZATION  MODULE  (INTDSP) 

1.4.1  Subcomponent  Descriptions.  The  SEDS  initialization  module 
is  called  by  the  SEDS  Resident  Program  each  time  control  is  re- 
turned there  for  data  processing  change  or  termination.  The  module 
is  composed  of  several  subcomponents.  The  major  subcomponent, 
SEDINT,  is  responsible  for  the  set  up  of  interrupt  vectors,  emu- 
lator trap  (EMT)  vectors,  and  device  priority  levels.  Following 
call  up  of  the  initial  VT05  display  (see  figure  1-5),  control  is 
given  to  the  user  to  enter  the  program  call  letters  to  proceed. 

The  subcomponents  which  comprise  the  INTDSP  module  consist  of 
the  following: 

• "INTDSP" 

............ 

• SEDINT 

• DISKIO 

• GDUfW 

• VTLINK 

• FTNLIB 

1.4.2  Flow  Chart.  See  next  nine  pages. 

1.4.3  Listings.  See  Part  IV  of  this  document,  published  under 
separate  cover. 


1-20 


JS010019 
Part  II 


lAJ/dSP 


5£bLA]T 


tC/fLL  tf/AZAJ 
^U6-C4*iP0*)£J(il 


EEGEET 


(term? a}  T& 
We  oojti., 


REPRODUCIBILITY  OF  THE 
ORIGINAL  PAGE  IS  POOR 


1-21 


JSC-10019 
Part  II 


JSC-10019 
Part  II 


1-23 


Reproducibility  of  the 

.OEEGINAL  PAGE  IS  POH'R 


JSC-10019 
Part  II 


! t 


JSC-10019 
Part  II 


S 


JSC-10019 
Part  II 


SECTION  2 

SEDS  ENGINEERING  UNIT  CONVERSION  PROGRAM  (SEU) 

2.1  GENERAL  PROGRAM  CHARACTERISTICS 

The  SEU  Program  is  responsible  for  the  function  of  taking  raw 
pulse  code  modulated  (PCM)  data  from  an  edited  9 r track  computer 
compatible  tape  (CCT)  and  converting  the  infrared  (IR)  channel 
data  to  corrected  temperature  units.  This  involves  a calibration 
of  the  data  and  a correction  for  atmospheric  attenuation.  This 
results  in  a "best  estimated  surface  temperature"  in  degrees 
Kelvin  (°K).  The  visible  light  (VIS)  channel  data  is  not  pro- 
cessed since  it  is  not  required  in  radiometric  units  for  the 
purposes  of  its  use.  The  final  output  product  of  SEU  is  a 9-track 
CCT  containing  the  resultant  IR  temperature  units  and  the  unaltered 
VIS  data.  This  EU  processed  tape  will  be  used  as  input  to  the 
registration  processing  phase  -SRE  (discussed  in  paragraph  3.1). 

The  SEU  Program  consists  of  five  major  computer  program  components 
(CPC).  Each  major  CPC  is  a separate  load  module  that  must  be 
mapped  into  core  and  given  program  control  by  the  memory  segmenta- 
tion module,  SEG.  This  is  due  to  the  PDP  11/45  limitation  of  32K 
core  available  at  any  one  time  for  access.  Figure  2-1  illustrates 
the  SEU  Program  layout  and  the  CPC’s. 

A.  SEUCON.  This  is  the  controlling  EU  executive  CPC  load 
module.  Calls  to  the  other  four  CPC’s  are  made  from  this 
CPC.  The  actual  EU  processing  and  conversion  of  the  data 
is  performed  in  SEUCON. 

B.  EUDISP.  Performs  the  initialization  tasks  of  EU  and  inter- 
faces with  the  operator. 

C.  HEDREC . Processes  the  PCM  input  tape  header  and  builds 
the  EU  output  tape  header. 

D.  CALDAT . Responsible  for  retrieving  from  disk  storage  the 
calibration  data  file  used  by  SEUCON  in  processing  the 
data . 

E • ERRDSP . Responsible  for  displaying  of  error  conditions 
and  operator  advisories  during  job  execution. 
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The  following  paragraphs  explain  in  detail  the  functions  of  the 
CPC’s,  the  storage  allocations,  program  timing  and  sequencing, 
and  data  base  characteristics  of  the  SEU  Program. 

2.1.1  Functional  Allocations . As  stated  in  the  SISO-TN734,  the 
Functional  Requirements  Document,  the  purpose  of  the  SEU  Program 
is  to  convert  raw  PCM  IR  data  to  temperature  units  and  output  the 
corrected  IR  temperature  and  VIS  data  to  a 9-track  CCT.  This 
includes  calibration  of  each  IR  band  data  and  correction  for 
atmospheric  attenuation  using  a function  of  the  scan  angle  (0) 
measured  from  the  center  of  the  video  scan  line.  The  conversions 
from  PCM  count  to  temperature  units  are  accomplished  by  a table- 
lookup  scheme. 

The  calibration  of  the  IR  data  is  done  first.  This  means  that  the 
8-bit  digital  IR  video  voltage  samples  (V)  on  the  preprocessed 
tape  are  converted  into  16-bit  energy  values  E (V) . This  conver- 
sion needs  to  be  done  for  each  picture  element  (pixel]  in  a scan, 
so  an  E (V)  table  is  set  up  just  prior  to  processing  a scan  con- 
taining E (V)  values  for  V,  ranging  from  0 to  255.  Calibration 
data  is  extracted  from  the  scan  to  be  used  in  calculating  the 
E (V) ' s . This  table  must  be  recalculated  for  each  scan,  based  on 
the  calibration  data  received  with  each  scan  line  of  IR  image  data. 
The  exact  calculations  are  explained  in  paragraph  2.2.1. 

The  input  PCM  count  is  used  as  an  index  into  the  E (V)  table  to 
pick  up  its  corresponding  E (V)  energy  value.  The  next  step  in 
the  processing  is  to  take  the  "calibrated’'  E (V)  values  and  calcu- 
late a "corrected"  energy  value  Ec.  This  involves  a table  lookup 
in  a table  of  16-bit  values  computed  by  an  offline  FORTRAN  program. 
The  16-bit  corrected  energy  values  are  then  converted  to  an  8-bit 
encoded  temperature  value  (T)  by  means  of  a second  table  lookup. 

The  result  is  a surface  temperature  expressed  in  degrees  Kelvin. 

The  IR  temperature  units  and  VIS  data  (as  taken  from  the  PCM 
preprocessed  tape)  are  written  out  to  9-track  CCT,  creating  the 
EU  tape. 

SEUCON  is  the  CPC  responsible  for  all  of  the  above  data  conversion 
and  processing  requirements.  The  other  four  CPC's  (EUDISP,  HEDREC, 
CALDAT,  and  ERRDSP)  are  more  or  less  service  components  called  in 
from  the  SEUCON  CPC.  They  are  responsible  for  job  initialization, 
error  displaying  and  tape  header  generation. 
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2.1.2  Program  Flow  Chart.  See  figure  2-2  for  a general  flow  of 
the  SHU  Program  and  its  main  functions. 

2 . 1 . .3  Timing  and  Sequencing.  When  the  SEU  Program  is  brought  up 
for* job  execution,  the  SEUCON  CPC  is  in  main  control  of  the  oper- 
ation sequencing  and  program  control.  SEUCON  transfers  control 
to  the  other  CPC's  by  means  of  a call  to  the  memory  segmentation 
(management)  module,  SEG.  SEG  changes  page  address  registers  so 
as  to  "map"  the  requested  CPC  load  module  into  the  32K  portion  of 
core  for  program  execution.  This  also  involves  mapping  in  data 
areas  if  required,  which  might  call  for  disk  I/O  transfers  as  well 
as  transfers  from  program  modules.  Therefore,  more  time  is  in 
volved  than  with  a normal  direct  call  (JSR)  to  a program. 

SEUCON  first  makes  a call  to  SEG  to  map  in  EUDISP  to  perform  ini- 
tialization procedures.  This  includes  outputting  data  to  the  VT05 
in  form  of  a display  and  accepting  operator  inputs  for  job  setup. 

A second  call  is  made  to  SEG  to  map  in  HEDREC  to  read  the  input 
tape  leader,  extract  information  and  build  the  EU  output  tape 
header.  A third  call  to  SEG  is  made  to  map  in  CALDAT.  CALDAT 
utilizes  disk  I/O  to  retrieve  the  calibration  data  files  perma- 
nently stored  on  disk.  This  calibration  data  is  used  by  SEUCON 
in  its  calculations. 

SEUCON  reads  in  one  scan  line  of  data  from  the  preprocessed  9-track 
CCT,  performs  the  calibration  processing  of  the  scan,  and  converts 
the  IR  data  to  temperature  units.  The  data  is  then  written  out 
to  the  EU  tape.  All  tape  reads  and  writes  are  accomplished  by  the 
Disk  Operating  System  (DOS)  I/O  resident  routine  (NTRAN)  and  direct 
calls  are  made  to  this  routine  by  SEUCON.  Processing  continues  one 
scan  at  a time  until  all  of  the  input  data  has  been  read  in.  LRRDSP 
is  mapped  in  via  SEG  by  SEUCON  if  an  error  condition  occurs  during 
processing,  and  also  at  the  end  of  the  job  to  signify  to  the  oper- 
ator that  the  job  has  completed.  The  entire  processing  from  ini- 
tialization to  Completion  takes  approximately  15  minutes  of  CPU 
time. 

2.1.4  Storage  Allocation.  Figures  2-3  and  2-4  describe  the  stor- 
■ age  allocation  of  the  SEU  Program  and  how  the  CPC's  are  situated 
v in  core  , physical  and  virtual;-  As  explained  eralier,  SEDS  in- 
corporated the  $se  of  a 'memory  segmentation  module  to  provide  for 
the  most  efeicitnt  us^1  of  core  during  execution  time,  and  also  to 
-allow  tfrogtam  cajyabilijty  in  a somewhat  limited  addressable 
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area  of  32K  core.  Figure  2-3  is  a layout  of  the  32K  virtual 
memory  during  SEU.  As  each  of  the  other  CPC’s  are  mapped  into 
this  32K  area,  the  program  module  is  mapped  in  at  60000  for  how- 
ever much  core  it  requires.  Figure  2-3  shows  that  all  of  the 
other  CPC's  are  much  smaller  than  the  SEUCON  CPC.  When  each  CPC 
has  relinquished  control  to  SEUCON,  SEG  remaps  SEUCON  to  virtual 
32K  beginning  again  at  60000. 

If  a data  module  is  associated  with  a particular  CPC  load  module, 
it  is  mapped  in  with  the  CPC  beginning  at  140000,  or  from  24-28K. 

It  is  always  mapped  in  at  4K  blocks  (no  less) . The  resident  and 
DOS  area  at  0-12K  (0-60000)  is  never  altered  or  overlayed  in 
core,  nor  is  SEG  at  28-32K  (160000-177777  virtual). 

The  SEU  Program  is  situated  in  physical  memory  as  seen  in  figure 
2-4.  Those  modules  with  the  same  extensions  are  potentially  over- 
lays of  each  other;  they  would  do  so  if  the  physical  memory  re- 
quired was  greater  than  the  available  128K.  However,  in  SEU,  all 
programs  are  memory -r es ident  since  there  is  enough  free  physical 
core.  If  program  overlay  in  physical  memory  had  been  necessary, 
those  modules  with  the  same  extensions  for  which  there  was  no  free 
core  would  reside  on  disk  and  would  be  read  in  from  disk  as  needed. 

All  data  and  tables  used  by  two  or  more  of  the  CPC’s  in  SEU  are 
contained  in  the  resident  area  as  common  data  so  they  can  always 
be  accessed.  Each  CPC  may  have  its  own  data  area  associated  with 
it,  and  may  also  have  data  flags  and  tables  within  the  individual 
routines  composing  the  CPC. 

The  SEU  Program  contains  four  separate  data  modules  mapped  in 
individually  or  with  a particular  CPC  (VDPBUF,  INDATA,  CALBUF, 
and  FTABUF) . . SEUCON  uses  FTABUF , INDATA  and  CALBUF  data  modules. 
INDATA  is  used  as  an  internal  data  buffer  for  reading  in  data 
from  the  raw  input  tape.  CALBUF  and  FTABUF  contain  calibration 
data  read  in  from  disk  by  CALDAT  and  used  by  SEUCON  in  the  EU 
calculations.  The  EUDISP  CPC  uses  the  INDATA  buffer  to  read  in 
the  input  tape  header  to  extract  necessary  data,  for  use  later 
by  HEDREC  in  generating  the  output  header.  VDPBUF  is  initially 
mapped  in  by  SEUCON  to  set  it  up  in  physical  core  for  later  use 
in  VT05  input/output  requests. 
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2.1.5  Data  Base  Characteristics 

A.  File  Description.  As  discussed  previously,  there  are  data 
files  associated  with  the  individual  CPC's  in  the  SEU  Pro- 
gram (i.e.,  data  areas  mapped  in  at  the  same  time  with  a 
CPC  load  module  when  called  via  SEG) . Some  of  the  data 
files  are  mapped  in  via  SEG  independently,  and  are  not 
associated  with  one  particular  load  module.  These  provide 
for  a transfer  of  data  from  one  CPC  to  another.  There  are 
also  data  files  unique  to  a particular  CPC  and  these  are 
located  internally  in  routines  and/or  subroutines  in  each 
CPC.  These  will  be  discussed  in  the  CPC  data  organization 
paragraph  for  each  CPC.  Data  files  called  in  by  SEG  with 
or  without  a load  module  are  mapped  in  at  virtual  memory 
address  140000-157777  (24-28K) . Figure  2-4  illustrates  the 
physical  core  layout  of  the  data  files. 

1.  INDATA.  This  is  an  integer  array  file  1530pQ  words 
long  mapped  in  with  the  EUDISP  CPC.  It  is  used  for 
purposes  of  reading  the  input  tape  header  in  to  gather 
information  necessary  for  EU  initialization.  INDATA 
is  then  used  by  the  HEDREC  CPC  to  extract  data  from 
the  header  to  build  the  EU  output  tape  header.  This 
data  file  is  also  utilized  by  the  SEUCON  CPC  as  an 
intermediate  input  buffer  for  the  raw  PCM  input  data 
(one  scan  at  a time) . HEDREC  and  SEUCON  map  INDATA 
independently  when  required. 

2.  CALBUF.  This  is  a multifile  containing  three  table 
arrays  (two  floating  point  and  one  integer)  and  consist- 
ing of  a total  of  3 1 9 6 p o words.  Figure  2-5  is  a graphic 
description  of  CALBUF.  The  two  floating  point  arrays,  T 
and  E(T),  consist  of  predetermined  temperature  and  energy 
values  to  be  used  by  SEUCON  in  the  calibration  processes 
(see  table  2-1).  The  integer  array  ITETAB  contains  pre- 
determined corrected  temperature  values  and  is  utilized 
as  a "lookup  table"  by  the  SEUCON  CPC  in  the  final 
stages  of  the  EU  conversion.  The  CALBUF  data  file  is 
mapped  in  with  the  CALDAT  CPC,  where  the  calibration 

and  lookup  tables  are  transferred  from  disk  storage  to 
the  CALBUF  file. 
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TABLE  2-1 

CONTENTS  OF  T AND  E(T)  ARRAYS  ON  CALBUF 


T(°K) 


S490 .8 

6556.7 

6623.0 

6689.8 

6757.0 

6824.6 

6892.5 

6961.0 

7029.7 

7099.0 

7168.6 

7238.7 

7309.1 

7380.1 

7451.2 
7522 . S 
7595. C 
7667  .! 
7740.! 
7813  J 
7887.! 
7961. 
8036  .< 
8111.: 
8186. 

5 8262. 

8338. 
8415. 
8492. 
8570. 
8647. 
8726. 
8805. 
8884. 
8963. 
9043. 
9124. 
9205, 
9266 
9367 
9449 
9532 
• 9615 
9698 
9782 
.5  9866 


.81250 
.77734 
.08984 
.85938 
.03906 
.60156 
.57813 
,01563 
.79688 
i.  04688 
!.  65234 
1.71484 
>.13281 
1.10156 
..23125 

i.  9 1406 

j.  02344 
1 .57031 
1.55078 
3.85938 
7.59766 
1.78516 
6.41406 
1.35156 
6.77344 
2.66016 
8.83203 
5.48438 
2.56641 
0.04688 
7.98828 
6.33594 
>5.04297 
>4.21875 
>3.85938 
+3.  77734 
►4.26563 
15.03906 
36.33203 
67.96875 
49. 96484 
32.53125 
15.47656 
98.82813 
82.55469 
66.73047 


273.0 


E y 


i j 
1 


9951.3 

10036.3 

10121.7 

10207.6 

10293.6 
10380  .! 

10467.6 

10555.1 

10643 .1 
10731.! 
10820 J 
10909.! 
10999.! 
11089.: 
11179.  < 
11270.- 

11361.1 
11453.: 
11545 . ' 
11638. 
11731. 
11824. 
11918. 
12012. 
12107. 
12202. 
12297. 
12393. 
12490. 
12586. 
12684. 
12781. 
12879, 
12978. 
13076. 
13176. 

i 13275 
, 13375 

) 13476 

> 13577 

) 13678 

> 13780 

) 13882 

5 13985 

0 14088 

14191 


.34766 
.32813 
.73438 
.62109 
.86719 
.54297 
,62891. 
.17969 
.16406 
.52344 
.24219 
'.50391 
'.12109 
'.14453 
> .64844 
(.49219 
..81250 
\ .58984 
j .63281 
5.24609 
L. 20703 
+.62109 
3.43750 
2.  69141 
7.25391 
2.39453 
7.87500 
3.76563 
0.07813 
6.87109 
4.02734 
1.71875 
9.57422 
8.03125 
6.90234 
6.10547 
5.75391 
'5.85156 
'6.40234 
7.40625 
►8.62500 
JO. 535  1.6 
32 .59375 
35.25781 
38.10156 
91. 59766 
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TABLE  2-1  (CONT'd) 

CONTENTS  OF  T AND  E(T)  ARRAYS  0\i  CALBUF 


T(°K)  E(T) 


14295.39063 
14399 ,83594 
14504.49219 
14609.44141 
14715.07031 
14820.85156 
14927.24609 
15034.11719 
15141.25391 
15248.91797 
15356.78516 
15465.20313 
15574.03516 
15683.25000 
15792.93750 

15902.95313 
16013.47656 
16124.34375 
16235.66016 
16347.39844 
16459.50391 

16572.04297 
16684.99609 
16798.41797 
16912.07813 
17026.30469 
17140.87500 
17255.91406 
17371.26563 
17487.19922 
17603.31641 

17720.04297 
17837.08203 
17954.54688 
18072.36328 
18190.63281 
18309.37891 
18428.38281 

18547.95313 
18667.81641 
18788.10547 
18908.80859 
19029.99219 
19151.48438 
19273.44531 

ltt£U2U& 


T(°K) 

E(T) 

317.0 

19518.45703 

317.5 

19641.64844 

318.0 

19765.12109 

318.5 

19889.09375' 

319.0 

120013.29297 

319.5 

20138.29688; 

320.0 

20263.27734 

320.5 

20388.87109 

321.0 

20514.89063 

321.5 

20641.24609 

322.0 

20767.90625 

322.5 

20895.16016 

323.0 

21022.62500 

323.5 

21150.55078 

324.0 

21278.92969j 

324.5 

21407.66797 

325.0 

21536.82031 

325.5 

21666.30859 

326.0 

21796.26953 

326.5 

21926.66797 

327.0 

22057.36328 

327.5 

22188.51172 

328.0 

22320.03125 

328.5 

22451.92188 

329.0 

22584.25781 

329.5 

22716.94531 

330.0 

22850.04297 

330.5 

22983.50000 

331.0 

23117.41016 

331.5 

23251.71875 

332.0 

23386.44531 

332.5 

23521.51953 

333.0 

23656.92188 

333.5 

23792.71094 

334.0 

23928.93750 

334.5 

24065.66797 

335.0 

24202.55078 

335.5 

24340.01172 

336.0 

24477.82031 

336.5 

24615.96875 

337.0 

24754.56641 

337.5 

24893.51172 

338.0 

25032.88672 

338.5 

25172.58984 

339.0 

25312.63281 

339.$ 

25453.18359 

. j 
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3 FTABUF  This  data  file  contains  3523jg  16-bit  F(ag,  6) 
vaiuTt  in  floating  point  (actually  704610  words).  Pre- 
determined F(a0,  6)  values  are  read  from  disk  stored 
in  FTABUF  by  the  CAL  DAT  CPC,  and  used  by  SEUCON  m the 
atmospheric  correction  algorithm.  FTABUF  is  mapped  in 
independently  by  the  CALDAT  and  SEUCON  CPC  s. 

Item  Description.  In  the  SEU  Program  are  flag  anc^  a 

data  stored  in  common,  accessible  to  all  of  the  CPC’s.  An 
area  in  RESIDENT  is  set  up  for  this  common  data  to  enable 
a passing  of  flags  or  data  between  the  individual  load 
modules.  All  common  data  items  are  16-bit  integer  values 
unless  otherwise  specified. 

I.  SEDCOM.  This  contains  the  following  processing  data 
words . 

• INIT,  a flag  for  load  module  (CPC)  communication 
(©^initialization , l=continue  processing,  and 
2=terminate) . 

• I PASS , a flag  to  indicate  the  type  of  pass  for  the 
job  (0=day  pass  and  l=night  pass) . 

• ILOUT , the  output  tape  logical  unit  number 

• IDT APE , and  EBCDIC  tape  identification  set  up  lor 
the  output  tape  (five  integar  words). 

• ISENSR,  sensor  identification  as  relleeted  in  the 
input  tape  header. 

2.  ERROR.  This  contains  parameters  Jor  ERRDSP,  the  eitoi 
display  routine  CPC,  as  follows. 

• IERR,  the  error  message  code  (range  of  1-300) 

• IUNIT,  the  logical  unit  on  which  the  error  occurred, 

3.  TPFRMT.  This  contains  data  extracted  from  the  input 

header  describing  the  tape  format,  as  follows. 

» 
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• 

IRCSET, 

records  per  data  set 

NVIDEO, 

the 

number  of  video  elements  within  a 

channel 

IRCSZE, 

the 

physical  record  size 

in  words 

IANCSZ, 

the 

ancillary  record  size 

in  bytes 

IFSPIX, 

the 

starting  pixel  number 

on  input  tape 

IENPIX, 

the 

ending  pixel  number 

• 

ICHSZE, 

the 

total  bytes  per  scan. 

per  channel. 
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2.2  SEU  CPC  CHARACTERISTICS 


The  following  paragraphs  contain  detailed  descriptions  of  the  five 
computer  program  components  outlined  in  paragraph  2.1.  The  in- 
struction listings  contained  herein,  by  inclusion  or  reference, 
specify  the  exact  configuration  of  the  SEU  Program.  Each  CPC 
will  be  discussed  individually  in  the  following  sections  as  CPC 
No . 1 , CPC  No . 2 , etc. 

2.2.1  SEUCON  (CPC  No.  1).  The  SEUCON  CPC  is  the  major  load  module 
0f  t)ie  SEU  Program.  It  lets  as  the  controller  of  the  EU  processing 
utilizing  the  other  four  CPC's  for  purposes  of  initialization  and 
to  perform  necessary  services  during  the  run.  SEUCON  is  responsible 
for  the  actual  data  conversion  of  the  raw  data  to  temperature  units 
as  stated  in  paragraph  2.1.1.  The  majority  of  SEUCON  load  module 
routines  are  written  in  PDP  11/45  FORTRAN  language.  The  routines 
and  subroutines  of  SEUCON  are  described  in  the  following  paragraphs. 
The  major  interfaces  include  tape  and  disk  I/O  via  an  NTRAN  resi- 
dent routine,  and  internal  subroutine  interfaces  to  accomplish  the 
table  lookups  and  conversions  of  the  data.  See  figure  2-6  for  a 
virtual  core  layout  of  the  SEUCON  load  module. 


2.2.  L. I SEUCON  Subcomponent  Description . The  SEUCON  CPC  contains 
a number  ^Tliajcvr- subcomponents , the  SEUCON  main  routine,  EVCONV, 
ECCONV,  TAGCUK,  FIXDAT,  FILSCN,  FILTER,  TBLOOK,  TAPE  IN , TP  E Oil  i , 
and  TBSRCH.  This  paragraph  will  discuss  in  detail  the  functions 
and  design  flow  of  SEUCON  and  the  part  that  each  subcomponent 
is  responsible  for  to  carry  out  these  functions. 


SEUCON  Main.  This  is  the  major  subcomponent  of  the  SEUCON 
load  module.  In  fact,  it  is  the  routine  responsible  for 
controlling  the  sequence  of  processing  and  calling  the 
other  CPC's  as  well  as  its  own  subcomponents.  The  func- 
tions of  each  subcomponent  are  briefly  described  below, 
followed  by  a detailed  writeup  of  the  processing  flow 
of  SEUCON. 


B . 


EVCONV.  This  is  a FORTRAN  routine  that  performs  the  call 
bration  processing,  a scan,  at  a time,  creating  calibrated 
E(V)  "energy  values"  in  a table  for  use  in  further  con- 
versions . 
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C.  HCCONV.  This  is  an  assembly  routine  that  takes  the  cali- 
brated energy  values  E(V)  and  converts  them  to  temperature 
units  to  complete  the  EU  conversion. 

P . TAGCHK . This  performs  checks  on  the  incoming  scan  for  a 
valid  channel  tag  (FORTRAN) 

P • FIXDAT . When  a tape  read  error  occurs  on  the  input  tape, 
this  FORTRAN  subroutine  corrects  the  scan  and  sets  up  Its 
ancillary  record,  if  necessary. 

F.  F I LSCN . This  FORTRAN  subroutine  outputs  zero-fill  scans 
to  the  EU  output  tape  when  certain  conditions  occur  (i.c., 
time  discontinuity,  data  dropouts  on  raw  input  tape). 

G.  FILTER.  This  calculates  a ’’filtered"  value  for  scan  voltage 
values  used  in  the  calibration  computations  (FORTRAN) . 

b.  TBLOOK.  This  is  an  assembly  subroutine  that  performs  the 
actual  table  lookups  using  an  input  index  table  (set  up  by 
the  calling  routine)  and  a fixed  value  table  of  data  entries 
to  be  picked  up. 

I.  TAPE IN.  This  is  a FORTRAN  routine  that  uses  an  I/O  rout ine 
(NTRAN)  residing  in  RESIDENT  to  read  in  the  raw  PCM  input 
tape. 

J.  TPEOUT . This  is  a FORTRAN  routine  thac  uses  an  I/O  routine 
(NTRAN)  residing  in  RESIDENT  to  write  the  EU  output  tape. 

K • TBSRCH.  This  is  a FORTRAN  subroutine  used  to  compute  E (Tp) 
for  a given  absolute  temperature  (Tp)  using  interpolation 
and  the  E(T)  table.  The  E(Tp)  is  used  in  the  computation 
of  E(V). 

SHUCON  when  first  given  control  by  the  SEDS-res ident  routine  uses 
SEG  to  map  in  the  EUDISP  CPC  to  perform  the  initialization  set- 
up for  processing.  The  HEDREC  and  CALDAT  CPC's  are  next  loaded 
into  core  to  set  up  the  EU  output  tape  header  and  to  read  the 
calibration  data  and  lookup  table  files  from  disk  into  their 
respective  data  files  for  later  use. 
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Now  the  processing  of  the  data  is  performed.  SEUCON  MAIN  calls 
TAPE IN  to  read  a scan  line  of  data  from  the  raw  PCM  tape  into  the 
INDATA  buffer.  Checks  are  made  by  TAGCHK  to  ensure  validity  on 
the  IR  or  VIS  scan.  Checks  are  also  made  for  data  dropouts,  time 
discontinuity,  invalid  calibration  data  and  errors  occurring  on 
the  tape  read.  FILSCN  or  FIXDAT  is  called  if  any  of  the  above 
conditions  occur,  either  to  correct  the  scan  or  to  insert  zero 
fill  to  the  output  tape.  SEUCON  transfers  the  input  data  from 
the  INDATA. SEG  buffer  to  an  internal  buffer  IPDATA,  in  which  all 
processing  of  the  data  is  to  take  place.  If  the  scan  read-in 
is  VIS  data,  it  is  output  directly  to  tape  by  TPEOUT.  If  the 
scan  is  IR  data,  the  first  step  in  processing  the  data  is  "cali- 
bration."' This  is  a conversion  of  the  IR  data  samples  to  16-bit 
energy  values,  E (V) . This  conversion  is  to  be  done  fcr  each  pixel 
in  a scan  of  IR  data.  The  voltage  data  within  each  particular 
scan  is  used  in  the  calculations . A table  lookup  approach  has 
been  implemented  in  the  design  of  this  phase  to  facilitate  pro- 
cessing and  more  straightforward  logic.  The  use  of  an  assembly 
language  subroutine  to  utilize  these  lookup  tables  provides  more 
efficient  use  of  time,  and  eases  future  program  changes.  So,  for 
a scan  of  input  IR  data,  SEUCON  calls  EVCONV  to  build  a "lookup" 
table  of  E (V) ' s by  extracting  the  voltage  data  from  the  scan  and 
calculating  energy  values  E (V)  for  every  possible  PCM  value  of  0 
to  255^. 

The  algorithm  used  by  EVCONV  in  computing  the  E (V) ’ s is 

EW  - e (FVBB^FVSS)'  * <V-FVSS) 

Where  : 

E (V)  = Energy  value  corresponding  to  a voltage  (V), 

an  8-bit  digital  sensor  output  voltage  value 
for  a given  pixel  of  IR  data.  NOTE:  If  V = 

FVSS , E (V)  is  set  to  0. 

E(T  ) = Energy  value  corresponding  to  a perfect  emitter  or 
R blackbody  at  an  absolute  reference  temperature  (TR) 
in  °K . 


as  follows. 


which  is 
(0  to  2 55-j_q) 
0 or  V.=s 
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e = Assumed  average  emissivity  of  earth’s  surface  in 

thermal  IK  bond  (ratio  of  the  average  surface 
emissivity  to  the  emissivity  of  the  onboard 
reference  source) . A value  of  e - 0.975  will  be 
used. 

FVSS  = Filtered  (for  noise  reduction)  space  scan  sensor 
output  voltage  value  corresponding  to  a time  when 
the  sensor  was  receiving  deep  space. 

FVBB  = Filtered  (for  noise  reduction)  blackbody  sensor 

output  voltage  value  corresponding  to  a time  when 
the  sensor  was  receiving  the  onboard  reference  source. 

The  procedures  for  calculating  TR,  E (TR) , FVgg,  FVBR  are  as  follows. 

2. 2. 1.1.1  Calculation  of  Reference  Temperature.  The  calculation 
of  reference  temperature  TR  to  use  for  each  scan  line  of  IR  data 
is  the  only  place  in  the  calibration  process  where  it  makes  any 
difference  which,  satellite  collected  the  data  (NOAA-2,  NOAA-3, 
or  NOAA-4)  and,  if  it  was  NOAA-3  or  NOAA-4,  which  sensor  (VHRR-1 
or  VHRR-2)  was  being  used.  In  all  cases,  8-bit  digitized  therm- 
istor voltages  in  the  scan,  V(T^),  V(T2)>  and  V(Tj),  are  used  to 
calculate  a filtered  value  of  Tr  for  each  scan  line.  See  table 
2-2  for  a layout  of  the  input  IR  scan  and  the  position  of  V(T^), 

V (T 2 ) , V (T3) , VSS,  and  VBB  within  the  scan.  These  calculation 
procedures  are  defined  below  for  each  satellite  and  sensor. 

A.  NOAA-2  Tp  Calculations  (Both  VHRR  Sensors).  All  filtering 
of  values  is  accomplished  by  a call  to  the  subroutine 
FILTER. 

If  V(T?)  < 50  counts,  then: 

Lt 

T = V (T  ) • 0.080442433  + 263.73  °K 
R 3 

If  V (T  ) >201  counts,  then: 

Lt 

Tr  = V(T  ) • 0.081436796  + 291.32  °K 

If  50  counts  £ V(T  ) £ 201  counts,  then: 

T = V (T?)  • 0.086611383  + 276.77  °K 
R 2 
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TABLE  2-2 
RAW  TAPE  BLOCKS 


ANCILLARY  BLOCK  (COUNTER  = 1*) 

BLOCK  BYTE 

DESCRIPTION 

1-4 

CURRENT  GMT  AT  START  OF  THIS  DATA  SET  (TENTHS  OF  MILLISECONDS) 

5-6 

CHANNEL  STATUS  FOR  THIS  SCAN.  LSB  OF  BYTES  5-6  (0  = CHANNEL 
IN  SYNC,  1 = CHANNEL  NOT  IN  SYNC),  ONE  BYTE  PER  CHANNEL 

7-68 

CHANNELS  3-64  NOT  APPLICABLE;  LSB  OF  EACH  BYTE  = 1 

69-70 

SCAN  LINE  NO.  ARBITRARY  BUT  SEQUENTIAL  FOR  EACH  SCAN  LINE 
OF  THIS  DATA  RUN 

VIDEO  BLOCK  (COUNTER  = 2*) 

BLOCK  BYTE 

DESCRIPTION 

1-2514 

CHANNEL  OF  DATA  (VARIABLE) 

1 

SAMPLE  AT  SPACE  SCAN  MASK  (VSS) 

2-2501 

VIDEO  ELEMENTS  (VARIABLE  NO.)  DURING  EARTH  SCAN 

2502-2508 

SEVEN  VOLTAGE  CALIBRATION  STEPS  (VQ  THRU  V g) 

2510 

A 300  °K  BLACKBODY  SAMPLE  LEVEL  (VBB) 

2511-2513 

THREE  300  °K  TEMPERATURE  SENSOR  RANGE  SAMPLES 
[V(T,),  V(T2)  AND  V(T3)] 

2514 

DATA  TAG  (7  = DATA  IS  IR;  6 = DATA  IS  VIS;  5,4  = NOT  USED; 
3, 2, 1,0  = HARDWARE  STATUS  INDICATORS) 

^COUNTER  IS  IN  THE  FIRST  TWO  BYTES  OF  THE  PHYSICAL  RECORD 

NOTE-  BYTES  OF  ZERO  FILL  ARE  REQUIRED  TO  COMPLETE  THE  PHYSICAL  RECORD  LENGTH 
SPECIFIED  IN  THE  HEADER  RECORD 
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If  filtered  value  of  TR  for  the  1th  scan  line  is  (FILTR)  , 
then: 

(FILTR)  = (FILTR)  . . + £ (TR.  - (FILTR)  . , 
i i - 1 K.  1 l-l 

where : 

K = 1-16  for  i (scan  line)  of  1-16,  respectively 
B . NOAA-3  Tp  Calculations 

1 . Temperature  Conversions 

a.  VHRR  - 1 (S/N  106) 

Tx  = 0.084830896  • V(T1)  + 284.548  °K 

T2  = 0.083842795  • V(T  ) '+  284.863  °X 

T3  = 0.1502448186  • V(T  ) + 273.121  °K 

b.  VHRR  - 2 (S/N  109) 

T1  = 0.07521153240  • V(T  ) + 284.275  °K 

T2  = 0.07569783944  • V(TJ  + 285.087  °K 

T3  = 0.1537599103  • V(T  ) + 272.012  °K 

2,  Filtering . Let  FTlp.p,  FT2i_I,  FT3i_i,  and  FTRj.-i  be 
the  filtered  Tp,  T2,  T3,  and  Tp  values  for  the  last  scan 
line  (i-1) . Let  Tip,  T2p,  T3j , and  TRp  be  the  un- 
filtered temperatures  for  the  current  scan  line  (i). 

Find  the  following. 

FT1i  = FT1i-l  + k (T1i"FT1i-l} 

FT2.  = FT2i_1  + | (T2.-FT2._p 

FT3  = FT3 . + \ (T3.-FT3.  .) 

leilODUCIBILITY  OF  THE 

;^-KAL  PAGE  IS  FOOfe 
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/ 


I 

Where : 

K = scan  line  number  when  it  is  =£16,  or  16  when 
it  is  > 16 

Set  Wi  = 2.  Then: 

If  | FT1 . - Tl. I >1  °K 

And  FT1 . < 287  °K  or  > 303  °K, 

l * 

Set  = 0 

Set  W£  = 2 . Then: 

If  I FT2 . - T2 . i >1  °K 
1 1 ' 

And  FT2 . < 287  °K  or  > 303  °K, 

1 ’ 

Set  W2  = 0 

Set  W3  = 1 . Then: 

If  I FT3 . - T3 . i >1  °K 
1 1 1 1 

Set  W3  = 0. 

Now,  find  the  following. 

W_  • FT1 . + W„  • FT 2 . + W„  • FT3 . 

mn  _ 1 1 Z 1 3 1 

i W1  + W2  + W3 

If  wx  + w2  + W3  = .0, 

» 

I 

Set  TR.  = FTR . , . 

1 l-l 

Then  find  the  following. 

FTR.  = FTR.  , + ~ (TR. -FTR.  _) 

1 l-l  K K 1 l-l' 
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Where : 

K = scan  line  number  when  it  is  ^ 16,  or  16  when 
it  is  > 16 

FTRi  is  then  the  current  filtered  value  of  the  ref- 
erence temperature  (TR)  . 

2. 2. 1.1. 2 Calculation  of  Energy  Value.  The  next  processing  task 
is  to  * calculate  E(TR).  If  the  calculated  value  of  TR  is  > 310  °K 
or  < 273  °K,  this  is  an  error  condition  and  we  must  set  E (V)  = 0 
for  all  256  values  of  V.  A call  is  made  to  TBSRCM  to  find,  for 
any  TR  between  273  °K  and  310  °K,  E (TR)  by  linear  interpolation 
betwen  the  two  nearest  values  from  the  E(T)  table,  which  contains 
hard-coded  values  of  E for  temperatures  from  215  °K  - 345  °K  in 
0.5  degree  increments. 

2 2 1.1,3  Calculation  of  FVSS  and  FVBB . The  following  calcula- 
tions "will  be  used  by  FILTER  to  find  the  filtered  values  FVSS  and 
FVBB  of  VSS  and  VBB , respectively,  for  the  current  scan  line  (i) . 

If  234  £ VSSj,  ^ 255  counts,  then: 

FVSS.  - FVSSi.1  + | (VSS.-FVSS._p 

Whe  re : 

K = 1-64  for  scan  line  numbers  1-64,  or  64  for  a scan  line 
number  >64 

If  VSS p is  the  outside  the  above  range,  this  is  an  error  condition 
and  we  must  set  E (V)  = 0 for  all  V. 

If  104  £ VBB p £ 164  counts,  then: 

FVBB.  = FVBB.  . + ~ (VBB. -FVBB  ) 

1 1-1  K 1 1“  -L 

Where : 

K = 1-32  for  scan  line  numbers  1-32,  or  32  for  scan  line 
numbers  > 32 

If  VBBi  is  outside  the  above  range,  this  is  an  error  condition 
and  we  must  set  E(V)  = 0 for  all  V. 
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2. 2. 1.1. 4 Setup  of  E (V)  Table.  If  no  error  conditions  were  de- 
tected in  the  preceding  calculations  of  Tr,  E (Tr)  , FVSS  or  FVBB, 
then  the  following  procedure  is  used  by  EVCONV  to  set  up  the 
256-place  table  of  16-bit  E(V)  values: 


For  all  V ^ FVSSi  (rounded  to  eight  bits)  and  for  V = 0 counts, 
set  E (V)  = 0.  For  all  V f 0 and  V < FVSSi  (rounded  to  eight  bits), 
find  the  following  as  16-bit  (integer)  words,  and  place  these  values 
in  the  E(V)  table: 


E(V) 


E(TR)i 


e(FVBBi-FVSSi) 


(V-FVSS. ) 

l 


2. 2. 1.1. 5 Remainder  of  Processing.  Having  completed  the  E(V) 
table  for  the  input  scan,  EVCONV  calls  TBLOOK  to  perform  the  table 
lookup.  TBLOOK  uses  each  PCM  pixel  value  in  the  scan  (IPDATA) , 
beginning  with  the  first  pixel,  as  an  index  into  the  E (V)  table 
to  pick  up  the  corresponding  E (V) . As  they  are  picked  up,  the 
E (V) ’ s are  put  into  the  intermediate  buffer  (IPDATA)  to  replace 
the  PCM  value.  For  example,  if  the  first  pixel  of  the  input 
scan  = 170^o  (PCM  value),  TBLOOK  would  index  into  E(V)  table  by 
170  to  get  E(V),  and  put  E(V)  into  the  first  pixel  position  of 
the  IPDATA  buffer. 


SEUCON  calls  ECCONV  to  convert  the  energy  values  [ E (V ) ] now  in  the 
IPDATA  buffer  to  corrected  temperature  units  T(EC)  to  complete  the 
EU  conversion  of  the  input  scan.  First,  ECCONV  applies  an  atmo- 
spheric correction  to  the  "calibrated"  E (V)  values.  Then  the 
corrected  energy  values  (Ec)  are  converted  to  encoded  temperature 
units  (T(EC).  This  is  accomplished  as  follows.  For  each  pixel 
a corrected  energy  value,  Ec  is  found  as  follows: 

E = E(V)  + AE 
c 

Where: 

AE  = (E(V)-E(A)]  • F(ao,0) 

If  E (V)  = 0,  then: 

E = 0 ; T = 0‘. 
c 


2-25 


JSC-10019 
Part  II 


y:  (a)  corresponds  to  an  effective  atmospheric  temperature  of  130 
°K  and  will  have  the  integer  value  of  4 384  . The  value  of  h’(ao»°) 
is  found  from  a table  of  3523  fixed  scale  16-bit  values  calculated 
by  an  off-line  FORTRAN  routine  (FTABLE) . This  table  (F TABUF)  is 
mapped  into  core  via  a SEG  call  to  be  used  in  this  portion  of  pro- 
cessing. The  pixel  number  (not  the  value  or  position)  of  the  in- 
put pixel  is  used  as  an  index  into  FTABUF  (i.e.,  if  starting  pixel 
number  = 300  then  pixel  No.  1 of  the  scan  uses  an  index  of  300  into 
FTABUF;  the  second  pixel  would  use  301  as  an  index,  and  so  on). 


The  16 -bit  corrected  energy  value  (Ec)  is  now  roundedto  an  11-bit 
integer  (E^)  as  follows: 


E'  = 
c 


INT 


E + 8 
c 

. 16 


This  process,  going  from  E(V)  to  E£ , is  done  for  each  pixel  in  the 
input  scan.  When  it  is  completed  with  all  pixels,  a call  to  1BL00K 
is  made.  TBLOOK  uses  the  E'  values  in  IPDATA  as  indices  into  a 
2048-place  table  of  8-bit  temperature  codes,  T(E^),  to  pick  up  the 
corrected  temperature  for  each  pixel  and  place  in  the  IPDATA  buf- 
fer. The  T(EC)  table  was  generated  by  inverting  the  E (T)  table 
via  an  off-line  FORTRAN  program,  ENTGEN,  and  was  stored  perma- 
nently on  disk, 

SEUCON  now  has  a fully  processed  IR  scan  to  be  output.  A call  is 
made  to  TPEOUT  to  write  the  scan  contained  in  the  IPDATA  buffer 
to  the  EU  output  tape.  SEUCON  continues  the  processing  loop  by 
reading  in  the  next  scan  vai  TAPE IN  and  repeating  all  of  the  above 
calculations.  When  all  of  the  input  scans  have  been  processed, . 
SEUCON  performs  cleanup  tasks,  notifies  operator  of  job  completion, 
and  returns  program  control  to  the  SEDS -r cs ident  routine. 

2. 2. 1.2  Flow  Charts . See  the  following  47  pages. 
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2,2. 1.3  Interfaces.  Thir,  paragraph  describes  the  interfaces  of 
the  SEUCON  CPC  with  the  other  CPC’s,  the  input  and  output  data 
external  to  the  CPC,  and  the  interfaces  of  the  CPC  with  its  own 
subcomponents . 

A.  Input  Data 

1.  Raw  PCM  9 -Track  Tape.  See  figure  2-7  and  table  2-2  fo 
a description  and  content  of  the  tape  and  format.  Ihe 
PCM  input  tape  is  read,  one  scan  or  record  at  a time, 
into  the  INDATA  buffer.  The  ancillary  record  is  read 
in,  followed  by  the  IR  channel;  if  this  is  a day  tape, 
the  VIS  channel  is  read  in  after  the  IR. 

2.  CALBUF.  This  is  a three- table  data  file  set  up  by 
CALDAT  CPC  that  contains: 


• T table,  absolute  temperatures 

• E(T)  table,  energy  values  corresponding  to  the 
absolute  temperaures  (T) 

• ITETAB  table,  a 2048-place  table  of  8-bit  tempera- 
ture codes  to  be  used  as  a table  lookup. 

j; 

See  figure  2-5  for  a layout  of  the  CALBUF  data  file. 

3.  FTABUF . This  is  a 3523-place  fixed-scale  table  con- 
taining 16-bit  F(cx0,0)  values  to  be  used  as  a table 
lookup.  This  input  data  file  is  set  up  by  the  CALDAT 
CPC  to  be  used  in  SEUCON  processing. 


B.  Output  Data.  The  only  output  data  of  the  SEUCON  CPC  is  a 
9 -track  EU  processed  tape.  It  contains  2200  data  sets 
(or  scans)  for  a day  pass  tape  and  2500  data  sets  for  a 
night  pass  tape.  Each  day  pass  data  set  includes  an 
ancillary  record,  IR  channel  record  (EU-converted) , and 
VIS  channel  record.  Each  night  pass  tape  contains  an 
ancillary  record  and  IR  channel  record  (EU-converted). 

See  figure  2-8  and  table  2-3  for  a format  layout  of  the 
EU  output  tape.  This  EU  processed  tape  will  be  used  as 
input  to  the  registration  phase  of  SEDS  (see  paragraph 
3.1). 
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ONE  CHANNEL 
NIGHT  PASS 


TWO  CHANNELS 
DAY  PASS 


HEADER  RECORD 

IRG* - 

. * 

ANCILLARY  BLOCK 

IRG .... 

VIDEO  BLOCK 

IRG 

ANCILLARY  BLOCK 

IRG 

VIDEO  BLOCK 

IRG 

ANCILLARY  BLOCK 

IRG 

EOF 

EOF 

EOF 

2 RECORDS 


DATA  SET 


3 RECORDS 


*IRG  * INTER-RECORD  GAP 


HEADER  RECORD 

IRG* 

ANCILLARY  BLOCK 

IRG 

VIDEO  BLOCK 

IRG  H 

VIDEO  BLOCK 

IRG 

ANCILLARY  BLOCK 

IRG 

VIDEO  BLOCK 

J IRG 

VIDEO  BLOCK 

A 

T 

EOF 

EOF 

EOF. 

Figure  2-7  SEDS  Raw  9 -Track  CCT  Format 
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NIGHT  PASS  TAPE 


DAY  PASS  TAPE 


1 RECORD 


DATA  SET 


2 RECORDS 


HEADER 

IRG* 

ANCILLARY  RECORD 

IRG 

I R VIDEO  RECORD 

IRG 

VIS  VIDEO  RECORD 

IRG 

ANCILLARY  RECORD 

IRG 

I R VIDEO  RECORD 

IRG  ...  . 

VIS  VIDEO  RECORD 

IRG 

ANCILLARY  RECORD 

IRG 

EOF 


EOF 


EOF 


*IRG  = INTER-RECORD  GAP 


Figure  2-8  EU  Processed  9-Track  Tape  Format 
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TABLE  2-3 

PROCESSED  TAPE  BLOCKS 


BLOCK  BYTE 

ANCILLARY  BLOCK  (COUNTER  = 1*) 
DESCRIPTION 

1-4 

5-6 

7-68 

69-70 

CURRENT  GMT  AT  START  OF  THIS  DATA  SET  (TENTHS  OF  MILLISECONDS) 

CHANNEL  STATUS  FOR  THIS  SCAN.  LSB  OF  BYTES  5-6  (0  = CHANNEL  IN 
SYNC,  1 = CHANNEL  NOT  IN  SYNC),  ONE  BYTE  PER  CHANNEL 

CHANNELS  3-64  NOT  APPLICABLE.  LSB  OF  EACH  BYTE  = 1 

SCAN  LINE  NO.;  ARBITRARY  BUT  SEQUENTIAL  FOR  EACH  SCAN  LINE  OF 
THIS  DATA  RUN 

VIDEO  BLOCK  (COUNTER  = 2*) 

BLOCK  BYTE 

DESCRIPTION 

1-2500 

CHANNEL  OF  DATA,  UP  TO  2500  VIDEO  ELEMENTS: 

(OR  LESS) 

• NIGHT  TAPE  VIDEO  BLOCK  = 2500  SCANS  (1-1800  ELEMENTS) 
t DAY  TAPE  VIDEO  BLOCK  = 2200  SCANS  (1-2500  ELEMENTS) 

♦COUNTER  IS  IN  FIRST  TWO  BYTES  OF  PHYSICAL  RECORDS 

NOTE:  BYTES  OF  ZERO  FILL  ARE  REQUIRED  TO  COMPLETE  PHYSICAL  RECORD  LENGTH 

SPECIFIED  IN  HEADER  RECORD 
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C.  Subroutines.  The  subroutines  called  by  the  SEUCON  CPC  are 
outlined  in  detail  in  paragraph  2. 2.1.1. 

I).  CPC  Interfaces.  SEUCON  is  called  directly  from  the  SEDS- 
resident  program  and  there  is  only  one  entry  point  to  the 
routine.  Interfacing  with  the  other  CPC’s  is  accomplished 
by  SEUCON  calling  them  in  for  program  control  by  a call  to 
the  memory  segmentation  module  (SEG) . 

2. 2. 1.4  Data  Organization.  As  previously  stated,  SEUCON  maps 
data  files  into  core  via  SEG  at  24-28K.  These  files  are  available 
for  access  by  the  other  CPC's,  as  well  as  the  common  data  in 
RESIDENT.  However,  each  CPC  has  data  unique  to  the  CPC  and  ac- 
cessible only  to  that  CPC  and  its  subcomponents.  This  data  (items, 
flags,  tables,  etc.)  is  contained  within  the  subcomponents,  so  it 
is  included  in  that  area  of  memory  set  up  for  the  CPC  load  module. 
Following  is  a list  of  data  items  and  tables  unique  to  the  SEUCON 
CPC. 

A.  COMMON/ STATUS  FLAGS  RETURNED  BY  TAPEIN  Routine 

1.  ISTAT1 . 1 = ancillary  record  returned;  2 = IR  channel 

record  returned,  and  3 = VIS  channel  record  returned. 

2.  ISTAT2 . 0 = normal  processing  and  1 = EOF/EOT  reached. 

3.  I CHECK.  0 = normal  and  1 = channel  zero- filled. 

B.  COMMON/ FI XCOM.  All  flags  are  initially  set  to  0.  They  are: 

• SCNTME,  time  of  current  scan  (double  precision  floating 
point  value,  four  words) 

• ISCAN,  current  input  scan  number 

• IRECNO,  current  record  counter 

• TMESAV,  time  of  previous  scan  (double  precision  floating 
point  value,  four  words) 

• ISLOUT,  output  scan  number 

• IRCSAV , record  counter  of  previous  record. 
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COMMON/ CHBUF/ I RCRD  and  IPDATA  (2518).  This  includes: 

• I RCRD,  the  record  counter 

• IPDATA,  a 2518  word  internal  buffer  where  the  channel 
of  data  (from  tape)  is  processed  and  output. 

COMMON/ TWOBUF/ INBUFF  (1260,  2) . INBUFF  is  a 2520-word 
double  buffer  used  by  TAPEIN  to  read  the  raw  input  data 
into  prior  to  moving  it  to  the  INDATA  SEG  buffer  for  trans- 
fer of  data  to  SEUCON. 

COMMON/ FLS TOR.  These  are  storage  words  for  values  calcu- 
lated and  filtered  values  to  be  used  in  the  calibration 
process  of  computing  the  E(V)’s  in  EVCONV.  They  are: 

Tl,  T2 , T3,  TR,  FT1 , FT2,  FT 3 , FTR,  FVSS , FVBB,  and  ETR. 

EFCTOR.  The  "e"  assumed  average  emissivity  correction 
factor  used  in  EVCONV  for  the  E (V)  calculations  is  0.975. 

COMMON/EVTABL/IEV  (256) . IEV  is  a 256-word  table,  initially 
set  to  O' s,  built  by  EVCONV  to  contain  the  calculated  E(V) 
values  for  every  PCM  count  (0-255).  The  IEV  table  is  used 
later  by  TBLOOK  as  a table  lookup  to  extract  the  E(V) 
corresponding  to  a particular  input  PCM  count. 

K1 , . K2  and  K3.  These  are  counters  used  in  the  filtering 
process  by  FILTER;  they  are  initially  set  to  0. 

I TAB . This  is  a temporary  storage  location  used  by  TBLOOK 
to  store  the  table  address  of  the  index  values  passed  by 
the  calling  routine. 

EAVAL . The  E (A)  value  corresponding  to  an  effective  atmo- 
spheric temperature  of  230.0  °K  is  4384.  It  is  used  by 
ECCONV  in  the  calculation  of  Ec. 
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2. 2.1. 5 Limitations.  As  each  scan  is  read  off  the  raw  input  tape 
by  TAPEIN,  checks  are  made  on  the  scan  time  contained  in  the  ancil- 
lary. If  there  is  a jump  in  time,  zero-fill  scans  are  output  to 
the  HU  tape  to  ensure  that  a full  tape  (inserting  for  dropouts) 

is  built  for  later  use  in  registration.  However,  there  is  no 
capability  to  determine  if  the  time  track  was  out  and  was  passing 
aPong  bad  time  and  good  sequential  data  scans.  So  the  SEU  Program 
must  assume  there  is  good  time  with  the  data  as  this  is  its  only 
means  of  correctly  determining  data  scan  dropouts. 

2. 2. 1.6  CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 

2.2.2  EUDISP  (CPC  No.  2).  This  is  the  load  module  for  the  SEU 
Program  that  is  responsible  for  initialization  and  operator  setup 
prior  to  the  actual  processing  of  the  data.  EUDISP  builds  a VT05 
display  with  information  stripped  from  the  input  header,  and  re- 
ceives and  processes  inputs  to  the  VT05  made  by  the  operations 
personnel.  All  of  the  routines  except  one  in  this  CPC  are  written 
in  PDP  11/45  assembly  language.  There  is  one  FORTRAN  routine  serv- 
ing as  a driver.  EUDISP  interfaces  with  the  resident  VT05  handler 
input/output  routines  to  accomplish  its  interaction  with  the  VT05 
display.  Interfaces  with  the  resident  NTRAN  routine  are  made  for 
the  required  tape  I/O  to  read  the  input  tape  header.  See  figure 
2-9  for  a virtual  core  layout  of  the  EUDISP  CPC. 

2,2. 2.1  Subcomponent  Descriptions.  EUDISP  is  one  of  the  smaller 
load  modules  of  SEU,  so  it  contains  relatively  few  subcomponents 
in  comparison  to  SEUCON.  The  subcomponents  are  as  follows: 

A.  DSPDRV.  This  is  a FORTRAN  routine  that  acts  as  a ’’driver." 
It  calls,  initially,  the  main  assembly  language  routine 
EUDISP.  To  provide  for  a valid  linkage  and  proper  calling 
between  CPC's,  those  load  modules  written  purely  in  assembly 
language  must  have  a FORTRAN  driver  that  is  first  given 
control  to  call  up  the  main  routine. 

B.  EUDISP  MAIN.  This  is  the  main  subcomponent  of  the  EUDISP 
CPC.  It  controls  the  logic  flow  and  the  calling  of  the 
other  subcomponents  to  perform  the  interfacing  with  the 
VT05  and  tape. 
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C.  VTLINK.  This  is  the  VT05  routine  that  uses  a defined  com- 
mand  string  table  to  output  a display  to  the  VT05  screen. 
This  routine  is  called  from  EUDISP  after  all  data  has  been 
collected  for  the  EU  initialization  display. 

I).  ERRDSP.  This  is  an  error  and  message  displaying  routine 

palled  by  EUDISP  if  certain  conditions  occur,  and  to  inform 
the  operator  of  any  advisories,  etc. 

E.  IWRITE.  This  routine  is  called  by  ERRDSP  to  log  out  to  the 
requestor  the  error  and/or  advisory  message  that  was  cur- 
rently displayed  on  the  VTU5. 


The  ERRDSP  and  IWRITE  Routines  are  described  in  paragraph  2.2.5. 

When  the  EUDISP  load  module  (CPC)  is  called  in  from  SEUCON  CPC, 
DSPDRV  has  control.  DSPDRV  calls  EUDISP  MAIN  to  take  over  program 
control.  EUDISP  outputs  a message  to  the  VT05  display  by  means 
of  an  EMT  (142)  call  to  the  resident  VT05  handler  (VT05H).  The 
actual  output  and  input  of  characters  to  the  VT05  is  handled  by 
two  interrupt  service  routines  (VTIN  and  VTOUT) . These  are  dis- 
cussed in  paragraph  8.2.1.  EUDISP  sits  in  a ’’wait"  loop  until 
the  operator  has  responded  with  a GO  command  to  the  output  message 
A VT05  command  special  processor  sets  a defined  flag  word  to  indi- 
cate that  a GO  command  was  ordered  by  the  operator.  EUDISP  now 
makes  a call  to  NTRAN  to  read  the  input  tape  header  into  the  IN- 
DATA  buffer  area.  Data  is  picked  up  from  INDATA,  converted  to 
ASCII  and  stored  in  the  VT05  display  command  string  buffer, 
call  is  made  to  VTLINK,  passing  the  display  data  formatted  for 
output.  The  EU  display  is  as  follows: 


^COMPLETE  EU  OUTPUT  TAPE  ID;  KEY  IN  ' GO 1 * 


PROGRAM:  SEUCON-EU  CONVERSION  PROCESSING 


DATE:  23  : JAN : 75 

RAW  INPUT  TAPE  I.D. 
EU  OUTPUT  TAPE  I.D. 


DAY  PASS  PROCESSING 
SPD-SEDS  T *MT0 

SED-  *MT1 


2-82 


JSC-10019 
Part  II 


EUDISP  waits  in  a loop  until  the  operator  has  completed  entries  to 
the  display  and  has  keyed  in  the  GO  command. 

EUDISP  now  sets  up  the  SEDCOM  data  common  in  RESIDENT,  Using  header 
data  and  operator  VT05  entries  to  be  used  by  SEUCON,  as  follows: 

* I LOUT  (EU  output  tape  logical  unit  number) 

4 IDTAPE  (output  tape  ID) 

t ISENSR  (flag  indicating  type  of  sensor  data  to  process). 

EUDISP  has  now  completed  the  EU  initialization  phase  and  exits 
back  to  SEUCON  via  the  DSPDRV  Routine.  If  any  error  conditions 
occurred  during  the  tape  read  (invalid  header  information,  etc.) 
a call  is  made  to  ERRDSP  to  display  the  required  error  message 
on  the  VT05. 

2.2. 2. 2 Flow  Charts.  See  the  following  five  pages. 
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2.2.2. 3 Interfaces 

A.  Input.  The  only  input  data  to  EUDISP  is  the  raw  PCM  input 
tape  header  on  the  preprocessor  9- track  CCT.  Refer  to 
table  2-4  for  a layout  and  content  description  of  the 
header  record. 

B.  Output . The  data  output  from  EUDISP  is  as  follows: 

1.  I LOUT.  This  is  a 16-bit  word  containing  the  logical 
unit  number  for  the  EU  output  tape,  ILOUT  is  used  by 
SEUCON  for  purposes  of  writing  out  the  data  to  the 
output  tape. 

2.  IDTAPE.  This  is  five  words  containing  the  EU  output 
tape  ID  in  EBCDIC  as  input  to  the  VT05  by  the  operator. 
It  is  used  by  HEDREC  in  building  the  output  tape  header 
record. 

3.  ISENSR.  This  is  a flag  word  indicating  the  type  of 
sensor  data  to  be  processed  (0  = NOAA  2,  1 - NOAA  3-1, 

2 = NOAA  3-2,  3 = NOAA  4-1,  and  4 = NOAA  4-2).  It  is 
used  by  EVCONV  to  determine  the  particular  calculation 
for  the  calibration. 

C.  Call.  EUDISP  is  called  by  SEUCON  via  a call  to  SEG  to 
map  in  the  EUDISP  load  module. 

2. 2. 2. 4 Data  Organization.  Each  CPC  has  data  that  is  related 
only  to  that  particular  CPC  and  is  internally  contained  and 
defined.  The  data  discussed  in  previous  sections  can  be  assessed 
by  the  other  CPC's  and  for  the  most  part  is  external  to  EUDISP. 

The  following  are  tables  and  data  items  unique  to  EUDISP: 

A.  MTUNlT.  This  is  a predefined  data  word  for  the  input  tape 
logical  unit  number,  the  parameter  passed  to  NTRAN  I/O 
routine.  It  = 9. 

B.  WRDCT.  This  is  a predefined  word  count,  the  parameter 
passed  to  NTRAN  as  the  number  of  words  to  read  in  for  the 
header  record.  It  = 1530. 
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TABLE  2-4 


SEDS  RAW  9-TRACK  CCT  IMAGERY  UNIVERSAL  FORMAT  HEADER  RECORD 


BYTE 

CONTENTS 

DESCRIPTION 

1-32 

SEDS 

COMPUTING  SYSTEM  ID  (EBCDIC) 

33-52 

TAPE  LIBRARY  NO.  (EBCDIC) 

33-35 

SPD  FOR  DAY,  SPN  FOR  NIGHT 

36-41 

(NOAA  2 1 

TAPE  NO.  (XXXXXX) 

53-60 

(NOAA  3-1  & 3-2> 
(NOAA  4-1  & 4-2J 

SENSOR  ID  - EBCDIC 

61-63 

DATE  OF  THIS  TAPE  GENERATION  (EXAMPLE) 

61 

07 

DAY  OF  MONTH  (BINARY) 

62 

11 

MONTH  NO.  (BINARY) 

63 

74 

LAST  2 DIGITS  OF  YEAR  (BINARY) 

64 

1 

TAPE  SEQUENCE  NO.  (BINARY) 

65-66 

0 

MISSION  NO.  (BINARY) 

67-68 

0 

SITE  (BINARY) 

69 

0 

LINE  (BINARY) 

70 

0 

RUN  (BINARY) 

71-72 

ORBIT  (BINARY) 

73-80 

TIME  OF  FIRST  SCAN  IN  THIS  JOB  (CONTENTS  OF  THESE 
BYTES  SHOULD  REMAIN  CONSTANT  THROUGHOUT  JOB) 

73-74 

183 

TENTHS  OF  MILLISECONDS  (BINARY) 

75 

42 

SECONDS  (BINARY) 

76 

15 

MINUTES  (BINARY) 

77 

11 

HOURS  (BINARY) 

78 

21 

DAY  OF  MONTH  (BINARY) 

79 

09 

MONTH  NO.  (BINARY) 

80 

72 

LAST  2 DIGITS  OF  YEAR  (BINARY) 

81-88 

CHANNELS  ACTIVE  IN  THIS  JOB,  1 BIT  PER  CHANNEL  LEFT 
TO  RIGHT  (MSB  TO  LSB) . VIDEO  DATA  ALWAYS  APPEARS 
IN  THE  ORDER  INDICATED  HERE.  1 = ACTIVE 

81 

2008  OR  3008 

CHANNELS  1-8 

82 

000 

CHANNELS  9-16 

83 

000 

CHANNELS  17-24 

84 

000 

CHANNELS  25-32 

85 

000 

CHANNELS  33-40 

86 

000 

CHANNELS  41-48 

87 

000 

CHANNELS  49-56 

88 

000 

CHANNELS  57-64 

7 _ an 


^ggaSSSSSt 


JSC-10019 
Part  II 


TABLE  2-4  (CONT‘D) 


BYTE 

CONTENTS 

DESCRIPTION 

89 

0 

PROCESSING  FLAG,  BINARY  (0  = RAW,  1 - PROCESSED) 

90  ' 

1 OR  2 

NO.  OF  CHANNELS  IN  THIS  JOB,  BINARY  (SUM  OF  "ONES" 
IN  BYTES  81-88) 

91 

8 

PIXEL  SIZE,  BINARY  (NO.  OF  BITS  IN  A PIXEL) 

92-93 

2 

BYTE  ADDRESS  OF  START  OF  VIDEO  DATA,  BINARY  (GIVES 
LOCATION  OF  START  OF  VIDEO  WITHIN  SCAN) 

94-95 

96-97 

VARIABLE 

BYTE  ADDRESS  OF  START  OF  FIRST  CALIBRATION  AREA 
WITHIN  THE  SCAN,  BINARY 

NO.  OF  VIDEO  ELEMENTS  PER  SCAN  WITHIN  A SINGLE 
CHANNEL  (BINARY) 

§ DAY  TAPE  < 2500 

• NIGHT  TAPE  <L  1700 

98-99 

100-101 

12 

NO.  OF  CALIBRATION  ELEMENTS  IN  THE  FIRST  CALIBRA- 
TION AREA  WITHIN  THE  SCAN  IN  A SINGLE  CHANNEL  (BINARY) 

PHYSICAL  RECORD  SIZE  IN  BYTES  (BINARY) 

• DAY  TAPE  = 2520  OR  A LESSER  MULTIPLE  OF  180 

t NIGHT  TAPE  = 1800  OR  A LESSER  MULTIPLE  OF  180 

102 

1 

NO.  OF  CHANNELS  PER  PHYSICAL  RECORD  OF  DATA  SET 
STARTING  WITH  SECOND  RECORD  OF  DATA  SET  (BINARY) 

103 

0 

NO.  OF  PHYSICAL  RECORDS/SCAN/CHANNEL  (BINARY).  x 
ZERO  UNLESS  NO.  OF  ELEMENTS/CHANNEL  > 3K 

104 

2 OR  3 

NO.  OF  RECORDS  TO  MAKE  A COMPLETE  DATA  SET;  NEVER 
ZERO  (BINARY) 

105-106 

70 

LENGTH  OF  ANCILLARY  BLOCK  IN  BYTES  (BINARY) 

107 

0 

DATA  ORDER  INDICATOR,  BINARY  (0  = VIDEO  ORDERED  BY 
CHANNEL,  1 = BY  PIXEL) 

108-109 

1-3522 
(AS  INPUT) 

START  PIXEL  NO.  (ACTUAL  ONBOARD  PIXEL  NO.);  NO.  OF 
FIRST  PIXEL/SCAN  ON  THIS  TAPE  REFERENCED  TO  START  OF 
SCAN  (BINARY) 

110-111 

1-3522 
(AS  INPUT) 

STOP  PIXEL  NO.  (ACTUAL  ONBOARD  PIXEL  NO.)  NO.  OF 
LAST  PIXEL/SCAN  ON  THIS  TAPE  REFERENCED  TO  START 
OF  SCAN  (BINARY) 

2-91 


JSC-10019 
Part  II 


TABLE  2-4  (CONT'D) 


BYTE 

CONTENTS 

112-623 

112-115 

0 

116-239 

0 

240-243 

0 

244-367 

0 

368-371 

1 

372-495 

0 

496-499 

0 

500-623 

0 

624-687 

0 

688 

0 

689-750 

0 

751 

0 

752 

0 

753 

16 

DESCRIPTION 


COEFFICIENTS  AND  EXPONENTS-OF-TEN  TO  LINEARLY  TRANS- 
LATE PARAMETER  VALUES  FROM  AS  MANY  AS  64  CHANNELS  TO 
EU'S;  TWO  BYTES  PER  COEFFICIENT  OF  EXPONENT  WITH 
EACH  PAIR  OF  BYTES  EXPRESSED  IN  SIGNED  BINARY. 

(MSB  IS  A SIGN  BIT:  0 = PLUS,  1 = MINUS.  REMAIN- 

ING 15  BITS  ARE  STRAIGHT  BINARY.  FORMULA  IS: 


Y = Aq* 


10  u + C 


10 


■1 


WHERE: 

Y = EU'S  FOR  EACH  BAND 
C = PARAMETER  VALUE  FOR  EACH  BAND 

Ao  COEFFICIENTS  FOR  CHANNELS  1-2 
CHANNELS  3-64  NOT  APPLICABLE 
Eq  EXPONENTS  OF  10  FOR  CHANNELS  1-2 
CHANNELS  3-64  NOT  APPLICABLE 
At  COEFFICIENTS  FOR  CHANNELS  1-2 
CHANNELS  3-64  NOT  APPLICABLE 
Ei  EXPONENTS  OF  10  FOR  CHANNELS  1-2 
CHANNELS  3-24  NOT  APPLICABLE 


COLOR  CODE  INFORMATION,  ONE  BYTE/BAND  IN  SAME  ORDER 
AS  CHANNEL-ACTIVE-ON-THIS-TAPE  INDICATOR,  BINARY 
(0  = NOT  ACTIVE,  1 = RED,  2 = GREEN,  3 = BLUE) 

OFFSET  VALUE,  (BINARY);  USED  WITH  GAIN  VALUES 
(BYTES  689-750) 

GAIN  VALUES,  (BINARY)  APPLIED  TO  SIGNAL  LEVELS  FROM 
CHANNELS  1-62  FOR  LINEAR  COMBINATION 

PICTURE  ELEMENT  FIELD  WIDTH  (BINARY) ; SMALLEST  MUL- 
TIPLE OF  8 WHICH  > NO.  OF  BITS  IN  A PIXEL  (BYTE  91) 
ZERO  IF  PIXEL  SIZE  = 8 BITS 

PIXEL  REGISTRATION  (BINARY);  NO.  OF  BITS  THAT  LSB 
OF  PIXEL  IS  DISPLACED  FROM  LSB  OF  PIXEL  FIELD  (RE- 
FER TO  BYTE  751).  ZERO  IF  PIXEL  SIZE  = PICTURE 
ELEMENT  FIELD  WIDTH.  ANY  NON-ZERO  VALUE  IN  THIS 
BYTE  WILL  BE  DISCOURAGED. 

WORD  SIZE  OF  GENERATING  COMPUTER;  SMALLEST  QUANTITY 
IN  BITS  THAT  COMPUTER  CAN  WRITE  ON  TAPE  (BINARY) 
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TABLE  2-4  (CONT'D) 


BYTE 

CONTENTS 

DESCRIPTION 

754-1777 

SHORTEST  AND  LONGEST  WAVELENGTH  OF  EACH  CHANNEL 
(EBCDIC);  EIGHT  BYTES/LIMIT,  16  BYTES/CHANNEL 
(MILLIMICRONS) 

754-761 

010500 

CHANNEL  1 SHORTEST 

762-769 

012500 

CHANNEL  1 LONGEST 

770-777 

000600 

CHANNEL  2 SHORTEST 

778-785 

000700 

CHANNEL  2 LONGEST 

786-1777 

FILL  ZEROS 

1778 

0 

NO.  DATA  SETS/PHYSICAL  RECORD  (BINARY) 

1779-1780 

0 

BYTE  ADDRESS  OF  START  OF  SECOND  CALIBRATION  WITHIN 
A SCAN  (BINARY) 

1781-1782 

0 

NO.  CALIBRATION  ELEMENTS  IN  THE  SECOND  CALIBRATION 
AREA  WITHIN  THE  SCAN  IN  A SINGLE  BAND  (BINARY) 

1783 

0 

CALIBRATION  SOURCE  INDICATOR  (BINARY);  LSB  — SECOND 
SOURCE,  LSB+1  - FIRST  SOURCE  (0  = LOW  CALIBRATION 
SOURCE  DATA,  1 = HIGH  CALIBRATION  SOURCE  DATA) 

1784 

0 

FILL  ZERO 

1785-1786 

0 

NO.  CHANNELS  IN  FIRST  RECORD  OF  DATA  SET  (BINARY) 

1787-1788 

TOTAL  NO.  ELEMENTS/SCAN/CHANNEL  (BINARY) 

• DAY  PASS  £.  2514 

• NIGHT  PASS  £ 1714 

1789-1790 

1 

PIXEL  SKIP  FACTOR;  QUANTITY  TO  BE  ADDED  TO  THE  NO. 
OF  LAST  PIXEL  PROCESSED  TO  YIELD  NO.  OF  NEXT  PIXEL 
PROCESSED  (BINARY).  1 = EVERY  PIXEL  PROCESSED 

1791-1792 

1 

SCAN  SKIP  FACTOR;  QUANTITY  TO  BE  ADDED  TO  NO.  OF 
LAST  SCAN  PROCESSED  TO  YIELD  NO.  OF  NEXT  SCAN 
PROCESSED  (BINARY).  1 = EVERY  SCAN  PROCESSED 

1793-3000 

0 

FILL  ZEROS 

3001-3060 

0 

FILL  ZEROS;  MAKES  THE  RECORD  AN  INTEGRAL  NO.  OF 
COMPUTER  WORDS.  THESE  BYTES  MUST  NEVER  CONTAIN 
DATA 
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TABLE  2-4  (CONT'D) 


BYTE 

CONTENTS 

DESCRIPTION 

754-1777 

SHORTEST  AND  LONGEST  WAVELENGTH  OF  EACH  CHANNEL 
(EBCDIC);  EIGHT  BYTES/LIMIT,  16  BYTES/CHANNEL 
(MILLIMICRONS) 

754-761 

010500 

CHANNEL  1 SHORTEST 

762-769 

012500 

CHANNEL  1 LONGEST 

770-777 

000600' 

CHANNEL  2 SHORTEST 

778-785 

786-1777 

000700 

CHANNEL  2 LONGEST 
FILL  ZEROS 

1778 

0 

NO.  DATA  SETS/PHYSICAL  RECORD  (BINARY) 

1779-1780 

0 

BYTE  ADDRESS  OF  START  OF  SECOND  CALIBRATION  WITHIN 
A SCAN  (BINARY) 

1781-1782 

0 

NO.  CALIBRATION  ELEMENTS  IN  THE  SECOND  CALIBRATION 
AREA  WITHIN  THE  SCAN  IN  A SINGLE  BAND  (BINARY) 

1783 

0 

CALIBRATION  SOURCE  INDICATOR  (BINARY);  LSB  - SECOND 
SOURCE,  LSB+1  - FIRST  SOURCE  (0  = LOW  CALIBRATION 
SOURCE  DATA,  1 = HIGH  CALIBRATION  SOURCE  DATA) 

1784 

0 

FILL  ZERO 

1785-1786 

1787-1788 

0 

NO.  CHANNELS  IN  FIRST  RECORD  OF  DATA  SET  (BINARY) 

TOTAL  NO.  ELEMENTS/SCAN/CHANNEL  (BINARY) 

• DAY  PASS  <2514 

• NIGHT  PASS  ± 1714 

1789-1790 

1 

PIXEL  SKIP  FACTOR;  QUANTITY  TO  BE  ADDED  TO  THE  NO. 
OF  LAST  PIXEL  PROCESSED  TO  YIELD  NO.  OF  NEXT  PIXEL 
PROCESSED  (BINARY).  1 = EVERY  PIXEL  PROCESSED 

1791-1792 

1 

SCAN  SKIP  FACTOR;  QUANTITY  TO  BE  ADDED  TO  NO.  OF 
LAST  SCAN  PROCESSED  TO  YIELD  NO.  OF  NEXT  SCAN 
PROCESSED  (BINARY).  1 = EVERY  SCAN  PROCESSED 

1793-3000 

0 

FILL  ZEROS 

3001-3060 

0 

FILL  ZEROS;  MAKES  THE  RECORD  AN  INTEGRAL  NO.  OF 
COMPUTER  WORDS.  THESE  BYTES  MUST  NEVER  CONTAIN 
DATA 

)■ 

2-93 


JSC-10019 
Part  II 


C.  STATBF . This  is  a flag  word  in  which  NTRAN  passes  on  the 
I/O  status  for  error  detection;  it  is  initially  set  to  0. 

D.  JlllCMD  2 . This  is  the  VT05  display  command  buffer  string, 
and  contains  predefined  command  blocks  for  VTLINK  to  use 
in  outputting  the  display.  It  also  contains  data  set  up 
by  EUDISP  from  the  header  to  be  displayed. 

E.  EB2ASC . This  is  a predefined  table  containing  EBCDIC  and 
ASCII  representations  of  A-Z,  0-9,  and  special  characters. 
It  is  used  by  EUDISP  in  conversions  for  display,  etc. 

F.  MTMSG . This  is  a message  command  string  passed  to  VTLINK 
for  VT05  display. 

2 . 2 . 2 . 5 Limitations . None . 

2. 2.2.6  CPC  Listings.  See  Part  IV  of  this  document  published 
under  separate  cover. 

2.2.3  HEDREC  (CPC  No.  3).  HEDREC  (EU1)  is  the  CPC  of  the  SEU 
Program  responsible  for  building  the  EU  output  tape  header  record 
and  outputting  it  to  tape.  Some  of  the  information  on  the  input 
tape  header  stored  in  the  INDATA  buffer  is  used  in  setting  up 
the  EU  output  header.  HEDREC  interfaces  with  NTRAN  to  write  the 
output  header  to  tape.  The  HEDREC  load  module  is  written  in  PDP 
11/45  FORTRAN  language  and  assembly  language.  Refer  to  figure 
2-10  for  a virtual  core  layout  of  the  HEDREC  CPC. 

2. 2. 3.1  Subcomponent  Description.  HEDREC  is  composed  of  several 
subcomponents  or  subroutines,  all  used  for  the  function  of  creat- 
ing the  output  header  and  setting  up  the  resident  COMMON  TPFRMT 
for  use  by  SEUCON.  The  subcomponents  are  as  follows: 

A.  HEDREC  MAIN.  This  is  the  main  routine  in  the  HEDREC  load 
module.  It  is  responsible  for  the  logic  control;  setting 
up  the  TPFRMT  common,  partial  build  of  the  header,  and 
outputting  the  header  to  tape. 

B.  FIXWRD.  This  is  an  assembly  language  routine  called  by 
HEDREC  MAIN  to  pick  up  data  from  the  header,  byte-swap 
the  value,  and  store  them  in  the  TPFRMT  common. 
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MAXMIN  This  is  an  assembly  language  routine  that  sets 

bo,  Ai  and  El  coefftcents  into  the  output  header. 

WAVES  This  is  an  assembly  language  routine  that  sets  up 
tile- wavelength  values  in  the  output  header. 


C.  MAXMIN. 


D. 


The  HEDREC  load  module  is  called  from  the  SEUCON  CPC  via,  SBG  dur- 
inv  the  EU  initialization  phase  to  build  the  output  header  on  the 
EU8output  tape.  The  input  tape  header  had  been  previously  read 
Into  the  INDATA  buffer  by  EUDISP,  and  HEDREC  moves  it  to  an  in- 
ternal  working  buffer  (HEDBUF)  to  process  and  output  from.  HEDREC 
work s^with^ the  input  header  record,  making  necessary  modifications 
to  it  to  create  the  header  for  output.  The  output  tape  ID  (IDTAlfc), 
set  up  by  EUDISP  by  means  of  an  operator  VTOS  entry,  is  now  moved 
to  anPappropriate  position  in  HEDBUF.  HEDBUF  then  sets  up  the 
TPFRMT  common,  using  data  contained  in  the  input  header.  Calls 
are  made  to  FIXWRD  when  necessary  to  byte-swap  a data  value  prio 
to  living  it  to  the  common  data  file.  The  TPFRMT  common  contains 
the  following  information  from  the  header:  number  of  video  ele 

ments,  record  size,  size  of  ancillary  record,  beginning  pixel 
number  end  pixel  number,  and  channel  size  (see  paragraph  2.1.5 
for  a layout  of  the  TPFRMT  common).  HEDREC  calls  MAXMIN  to  set 
the  An,  At,  coefficients  and  EQ , Ex  exponents -of- ten  used  in 
HEDBU^  t o^l in early  translate  parameter  values  into  engineering 
units  WAVES  is  then  called  by  HEDREC  to  move  predetermine  wave 
length  values  to  their  appropriate  location  in  the  output  header. 
This  consists  of  the  shortest  and  longest  wavelength  of  each 
channel  in  EBCDIC  representation.  HEDREC  finishes  the  outpu 
header  by  setting  the  following  information  in  the  HEDBUF  output 
buffer-  start  of  video  data,  number  of  video  elements  on  output, 
start^f  ^ calibration  dad,  number  of  calibration  elements  and 
total  number  of  elements  per  scan  per  channel  on  output.  A u 
to  NTRAN  is  made  to  write  HEDBUF  (the  output  header  record) 
the  liU  output  tape  and  HEDREC  returns  control  to  SbUCON. 

2 # 2 . 3 . 2 Flow  Charts.  See  the  following  six  pages. 


2-96 


JSC- 

Part 


HEDftEC. 


~AA/7rV 

( //a  I4T3  //% 

7&  //4J  ezaJtz&vaa.  j 
x&-)7pt)A  ~$cAAZ7?t 


/ A/ot'sr, s 7fi?zr::cb. 
(aP.6A  C?as///S/J  ~76 
\37(J72k</4/-  Aor- 
\po7  2}qry&£. 


aata  /$tK 
77A&3XO 
s/te  7b 

’GS&Ajg- 

£>dTTxJ7 

J. 

jk  rtTp  A A 
~rp/r-/PA/y 

^2m^^rZ5 

7a£>  /XX£Z, 



a/A  'ca.  ' 

/t  y rf-y 

e; 

; ■AA}£.T~ 

<7M/  <&Z7 

""  ' - 1 

MXM/y 

T£7s 

&txrr/=r/  £>/£*/  -7S 
\J7U  A O-r&Jr , 


10019 

II 


a 


itsrxy  (J?  us? i/£" 

XmJ  p<?7?>oT  j 

S X / 


JSC-10019 
Part  II 


m:’ 

f^S 

‘I'.  ,,  1 

v i.  J / 

£ . rt  n*  *•  V V 

• "V.,  '.  -k 

* * H »■  . #‘ 

%,f  «:yV  '- 

Cu  >V  ■:■■  ’■ 

:f#  •*. 

• ■»’  -.  V 

,>  r , 

‘ L* . M ' ‘ 

»*r  ,<  l , t , 

;■  ■ 

1 !»■  A ■ 

. *.  • 

> * V 

> ’. :' 

* *’  J *! 

* * , ■ ; . 

* v-  ;•  • 

» . • r 

r ..  . 

/ . T;  . 

. ' ■ 

>4.  • 4 

^f'\h 

> r 

i 

t .. 

f •><'•••  ' •;•■ 

v •>•  ,f.- 

• a*  • ;■ 

i# 

;•  , *» 

y ;■  i 

I >.  >,  • 

j ' ‘ 

. . r‘  * (,  i 

^ . **  **' 

1 . : i , 

r % . ? . 

,r*.  ► i • 

V.'".  , / 

’•  'Sr'-.  »• " 

. f - ; 1? 

'in  * i 

if1  S 

* ( j- 

J'-  "*>  ■ - 

V .,  • ' • i 

y-'r&u  fi7Ux 
■3?&  aurPtj  r /4u?Aoe 

~<srU£T  <y~ 

^cj^z  * 

^ STU^s/gy/uTS 
'?Z>7??/.  ■* UUU/z-xsts 


LJuzjeUL\ 

' ^Zry,/Vz> 
i ' tefrpar  7??P<r , 


#£»b&±  /»  ' '7??£~ 
\ AurptJT  /?;?>.■  / 


/Za^2MaO\ 

^7&?SX  &&■<&, 
\OAJ  tO/SrrtC 
\ 997/oAJ  / 


vnmmmrn*,- 


JSC-10019 
Part  II 


JSC-10019 
Part  II 


JSC-10019 
Part  II 


REPRODUCIBILITY  OP  THE 
ORIGINAL  PAGE  IS  POOR 


v ; , ■:  * \-£ 


. * 
it 
<!i  • 

X : ■ 

Mi4* 


JSC-10019 
Part  II 

* 


JSC-10019 
Part  II 


2. 2. 3. 3 Interfaces 

A.  Input . The  input  data  to  HEDREC  is  the  input  raw  PCM  tape 
header  record  in  the  INDATA  buffer  read  in  by  EUDISP.  See 
table  2-4  for  the  layout  and  content  description  of  the 
header. 

B.  Output . The  output  of  HEDREC  is  HEDBUF,  containing  the 
header  output  to  the  EU  output  tape.  Essentially,  it  is 
the  input  header  data  with  the  modifications  required  to 
comply  to  the  tape  format  and  contents  of  the  EU  processed 
tape . 

C.  Subroutines.  HEDREC  calls  the  WAVES,  MAXMIN , FIXWRD,  and 
NTRAN  subroutines;  their  functions  are  outlined  in  para- 
graph 2. 2. 3.1. 

D.  Called.  As  stated  previously,  HEDREC  is  called  from  SEUCON 
during  the  initialization  phase  of  EU  following  the  call 

to  EUDISP.  HEDREC  is  called  once  for  each  EU  run  and 
there  is  only  one  point  of  entry  to  the  program. 

2. 2. 3.4  Data  Organization.  Discussed  in  this  paragraph  are  those 
data  items  and  tables  unique  to  HEDREC;  those  are  internally  de- 
fined and  unaccessible  to  the  other  CPC's  in  SEU. 

A.  COMMON/HEDBUF/IDAT(153Q) . HEDBUF  or  IDAT  is  a 1530-word 
integer  table  used  as  an  internal  header  output  buffer. 

Input  header  data  is  moved  to  this  buffer  and  changes  made 
to  particular  data  entries  within  to  set  it  up  for  output  to 
the  EU  output  tape. 

B.  MASK.  This  is  a 16-bit  integer  word  containing  the  value 
177776,  used  to  AND  with  a data  word  to  get  the  number  of 
video  elements  to  store  in  the  header  for  output. 

C.  ApBYT.  This  is  a 16-bit  word  containing  the  value  100624, 
used  by  MAXMIN  for  the  Aq  and  Eq  coefficient  values  to 
store  in  the  output  header.  Eo  is  in  the  high  order 
byte;  Aq  is  in  the  low  order  byte. 
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D.  AiBYT,  This  is  a 16-bit  word  containing  the  value  2 used 
ty  MAXMIN  for  the  and  E^  coefficient  values  to  store 

in  the  output  header.  Ej  is  in  the  high  order  byte;  Ax  is 
in  the  low  order  byte. 

E.  WAVTB.  This  is  a 16-word  byte  table  containing  predeter- 
mined short  and  long  wavelengths  for  Channel  1 and  Channel 

2 to  be  stored  in  the  output  header  by  the  WAVES  subroutine. 
These  8-bit  values  are  represented  in  EBCDIC. 

2. 2. 3. 5 Limitations . None. 

2.2. 3.6  Listings  . See  Part  IV  of  this  document  published  under 
separate  cover, 

2.2.4  CALDAT  (CPC  No.-  4).  CALDAT (EU1)  is  the  load  module  of  the 
SEU  Program  responsible  for  retrieving  calibration  data  in  the 
form  of  data  files  and  "lookup"  tables,  from  the  system  disk  for 
SEUCON  CPC  to  use  in  the  EU  conversion  calculations.  This  re- 
trieval of  data  requires  disk  I/O  interfaces  utilizing  DOS  I/O 
available  in  the  PDP  11/45  system.  Three  routines  or  subcompo- 
nents make  up  the  CALDAT  CPC;  the  main  "driver"  routine  is  written 
in  FORTRAN;  the  other  routines  in  assembly  language.  R.efer  to 
figure  1-10  for  a virtual  core  layout  of  the  CALDAT  CPC. 

2. 2. 4.1  Subcomponent  Descriptions.  Following  is  a description 
of  the  routines  or  subcomponents  of  the  CALDAT  CPC. 

A.  CALDAT  MAIN.  This  is  a FORTRAN  routine  that  controls  the 
logic  flow.  Its  function  is  to  map  into  core,  via  SEG, 
the  data  areas  into  which  the  calibration  data  is  to  be 
stored  and  to  call  the  routines  that  read  the  disk  files 
into  those  data  areas. 

B.  CALI.  This  is  an  assembly  language  routine  that  interfaces 
with,  the  DOS-supplied  disk  I/O  to  read  the  calibration  table 
EUTBLE.DA1  stored  on  disk  into  CALBUF  data  buffer. 

C.  CAL2 . This  is  an  assembly  language  routine  that  interfaces 
with  the  DOS-supplied  disk  I/O  to  read  the  calibration  table 
of  F 0*0*9)  values  (FTABLE.DAT)  stored  on  disk  into  the  FTA- 

BUF  dftta  buffer. 
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Figure  2-11  CALDAT  CPC  Virtual  Core  Map 
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CALDAT  is  called  from  SEUCON  just  prior  to  processing  the  input 
data  tape  so  that  CALDAT  can  set  up  the  calibration  tables  and 
lookup  tables  used  by  SEUCON  in  EU  conversion  processing.  This 
is  accomplished  by  a call  from  SEUCON  to  SEG  to  map  into  the  32K 
executable  core  the  CALDAT  load  module  and  CALBUF  data  buffer. 
CALDAT  MAIN  is  given  control,  and  in  turn  makes  a call  to  the 
CALI  routine.  The  two  routines  (subcomponents)  that  perform  the 
disk  reads  are  written  in  assembly  language  to  keep  the  execution 
time  low.  CALI  performs  the  DOS  I/O  calls  necessary  to  read  the 
EUTBLE.DA1  file  from  disk  into  CALBUF;  that  file  contains  T,  E (T) , 
and  ITETAB  tables.  T represents  absolute  temperature  values  from 
202.0  through  345.0  K increments;  E(T)  represents  energy  values 
corresponding  to  the  temperatures  contained  in  T;  and  ITETAB ^repre - 
sents  encoded  surface  temperature  values  set  up  as  a "lookup''  fable 
See  figure  2-5  for  a graphic  description  of  the  CALBUF  data  butter 

as  set  up  by  CALI. 

CALDAT  MAIN  next  maps  the  FTABUF  data  buffer  into  the  virtual  core 
area  from  24-28K  by  a SEG  call.  CAL2  is  called  to  perform  the 
DOS  I/O  calls  necessary  to  read  the  FTABLE.DAT  file  from  disk  into 
FTABUF.  FTABLE  contains  352310  words  of  F(aQ,0)  predetermined 
values  to  be  used  as  a lookup  table  in  the  atmospheric  correction 
algorithm  in  SEUCON.  Having  set  up  the  two  data  buffers  required 
in  the  EU  conversion  phase,  CALDAT  returns  control  to  SEUCON. 

2. 2. 4. 2 Flow  Charts.  See  the  following  five  pages. 
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2.2.4. 3 Interfaces 

A.  Input.  There  is  essentially  no  input  data  external  to  CAL- 
DAT.  The  CALBUF  and  FTABUF  data  buffers,  initially  zero, 
are  mapped  into  the  32K  environment  by  CALDAT  to  use  as  in- 
put storage  buffers. 

B.  Output.  The  data  output  by  CALDAT  is  the  two  data  buffers 
described  previously ,. formatted  and  filled  with  calibration 
data  and  lookup  tables  that  are  stored  permanently  on  disk. 

C.  Subroutines.  The  subroutines  called  by  CALDAT  are  CALI 
and  CAL2 . These  subroutines  do  the  reading  in  of  the  disk 
data  into  the  appropriate  data  buffers. 

D.  Called.  CALDAT  is  called  by  SEUCON  only  once  during  the 
initialization  phase,  just  prior  to  processing  the  input 
data.  CALDAT  is  called  after  EUDISP  has  completed  its 
initialization  functions  and  after  HEDREC  has  generated 
the  output  header. 

2. 2.4.4  Data  Organization.  This  paragraph  describes  the  data 
items  and  tables  unique  only  to  this  CPC,  and  that  data  internally 
located  and  defined  in  the  CPC. 

A.  LNK1 . This  is  the  link  block  table  used  by  CALI  in  inter- 
facing with  DOS  to  perform  the  initializing,  opening  and 
reading  of  the  specified  data  set  files  from  disk.  It  is 
formatted  as  follows. 


-2 

LNK1 : +0 
+ 2 
+4 
+ 6 


LO  BYTE 


ill  BYTE 


ERROR  RETURN  ADR  (0  = RETURN  TO  DOS) 


LINKAGE  ADR  SET  UP  BY  DOS 


NAME  OF  DATA  SET  IN  RADSO 


NO.  OF  WDS  TO  FOLLOW 


UNIT  NO.  OF  DEVICE 


NAME  OF  PHYS  DEVICE  TO  LINK  TO  IN  RAD50 
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B.  FIL1 . This  is  the  file  block  table  in  CALI  containing 
information  for  the  data  file  to  be  read  from  the  disk; 
it  is  used  by  DOS  in  performing  the  opening  and  reading 
of  the  disk  file.  It  is  formatted  as  follows. 


LO  BYTE  HI  BYTE 


-4 

ERROR  RETURN  ADR 

(0  - RETURN  TO  DOS) 

-2 

FUNCTION  CODE 

ERROR  CODE  RETURNED 

+ 0 

NAME  QF  DISK  FILE  IN 

+ 2 

RAD  50  AND 

EXTENSION 

+ 4 

USER  ID  CODE  (UIC): 

0 = CURRENT  UIC  USED 

+ 6 

PROTECT  CODE  (233) 

C.  BUF1,  This  is  the  buffer  block  table  in  CALI  used  by  DOS 
to  do  the  reading  of  the  disk  file.  It  contains  informa- 
tion on  the  length  of  the  file  and  the  format  in  which  to 
read  the  data.  It  is  formatted  as  follows. 


LO  BYTE  HI  BYTE 


BUF1 : +0 

SIZE  OF  DISK 

FILE  IN  BYTES 

+ 2 

FORMAT  BYTE 

STATUS  BYTE 

+4 

NO.  OF  BYTES  TO 

TRANSFER  ON  READ 

D.  LNK2 . This  is  the  link  block  table  in  CAL2  used  in  inter- 
facing with  DOS  to  perform  the  initializing,  opening  and 
reading  of  the  specified  data  set  file  from  disk.  It  has 
the  same  format  as  LNK1  above. 

E.  FIL2 . This  is  the  file  block  table  in  CAL2  containing 
information  on  the  data  file  to  be  read  from  disk.  It  is 
used  by  DOS  in  performing  the  opening  and  reading  of  the 
disk  file,  and  contains  the  same  information  as  FIL1  above* 
in  the  same  format. 
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F.  BUF2.  This  is  the  buffer  block  table  in  CAL?  ised  by  DOS 
to  do  the  reading  (transferring)  of  the  disk  file.  It  con- 
tains information  on  the  size  of  the  disk  file  and  the  for- 
mat in  which  to  read  the  data.  It  has  the  same  format  as 
BUF1 , 

2.2.4. 5 Limitations . None. 

2. 2. 4. 6 CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 

2.2.S  ERRDSP  (CPC  No.  5).  ERRDSP  is  actually  a service  utility 
module  for  use  by  any  CPC  module  in  SEDS . Its  function  is  to 
provide  an  error/advisory  message  displaying  capability  on  the 
VT05  screen  and  the  line  printer  for  all  of  the  CPC's  in  SEU.  Its 
main  purpose  is  to  enable  FORTRAN  routines  to  communicate  with  the 
operator  on  the  VT05,  since  the  existing  VT05  handler  and  input/ 
output  resident  routines  are  not  set  up  to  be  called  by  a FORTRAN 
routine.  The  major  interfaces  of  ERRDSP  are  with  the  VT05  routine 
residing  in  RESIDENT  in  order  to  utilize  the  VT05  output  features. 
ERRDSP  is  written  mainly  in  PDP  11/45  assembly  language  with  the 
exception  of  two  routines.  ERRDSP,  being  an  assembly  language 
load  module,  must  have  a FORTRAN  driver  in  order  to  be  called  by 
the  other  CPC's  via  SEG.  One  of  the  service  routines  is  also 
written  in  FORTRAN.  See  figure  2-12  for  a virtual  core  layout  of 
the  ERRDSP  CPC. 

2. 2. 5.1  Subcomponent  Descriptions.  Following  is  a list  and 
descriptions  of  the  subcomponents  comprising  the  ERRDSP  CPC. 

A.  ERRDRV.  This  a FORTRAN  language  routine  used  as  a driver 
for  calling  the  main  routine  of  the  load  module.  This 
routine  is  the  linkage  calling  routine  between  the  other 
CPC  load  modules  and  ERRDSP. 

B.  ERRDSP  MAIN.  This  assembly  language  routine  is  the  main 
subcomponent  and  is  responsible  for  setting  up  the  messages 
and  making  calls  for  interfacing  with  the  VT05  and  line 
printer. 
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Figure  2-12  ERRDSP  CPC  Virtual  Core  Map 
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C.  I WRITE . 


This  is  a FORTRAN  routine  called  from  ERRDSP  MAIN 


D. 


tTmFoutput s a specified  message  to  the  line  printer 

VT05H.  This  is  an  assembly  language  VTO 5 handler  routine  in 
■RESTDBNT  responsible  for  all  outputs  to  the  VT05.  A con 
mand  package  is  passed  to  VT05H  when  called  to  designate 
an  output  function  and  format. 

ERRDSP  is  called  whenever  a CPC  of  SEU  or  any  SEDS  program  has  a 
“to  notify  the  operator  of  an  error  condition  or  to  make  a 
request  for  operator  action  by  displaying  on  the  VT05  a specific 
canned  message.  ERRDSP  is  called  by  a SEG  call,  and  ^ntrol  1 
given  to  the  FORTRAN  driver  ERRDRV.  ERRDRV  in  turn  calls  ERRDSP 
to  do  the  actual  message  handling.  Prioi  to  making  a 
to  the  ERRDSP  CPC.  the  calling  routine  must  set 
a data  file  residing  in  the  resident  common  data  area.  The  f 
is  the  ERROR  COMMON,  consisting  of  two  parameters  --  IERR,  tii 
error  code,  and  INUIT,  the  unit  on  which  the  error  occurred, 
applicable.  ERRDSP  addresses  to  pick  up  the  correct  message 
^displayed.  Error  codes  are  divided  into  two  sets  Codes  1-99 
are  for  messages  that  use  the  second  parameter  (IUNIT)  to  refer 

iz  raw  -red  s::rarie 

for  output  by  ERRDSP. 

ERRDSP  picks  up  the  address  of  the  requested  message  by  using  the 
“code  as  an  index  into  the  MSGTB1  or  MSGTB2  tables  (depending 
on  which  of  the  two  sets  the  error  code  belongs  to).  These 
tables  contain  address  pointers  to  the  various  messages  in  se- 
quential, numerical  order.  The  messages  themselves  are  in  t 
form  of  ASCII  character  strings,  terminated  by  a line  feed  c 
ter  (LF).  ERRDSP  transfers  the  character  string  to  an  output  buf 
fer  (MSGBUF) , inserting  ASCII  blanks  if  necessary  to  comp  ee  y 
fill  the  buffer.  If  the  error  code  is  of  set  1 (codes  0 99), 
ERRDSP  inserts  the  unit  number  contained  in  the  I™  T parameter 
on  the  end  of  the  canned  message  for  output.  A call  to  VT05H 
made  to  display  the  message  as  formatted  in  the  «PU 

buffer.  The  call  is  made  from  ERRDSP  by  means  of  an  EMT142,  pas- 
ing  the  address  of  a command  block  in  general  register  RO.  The 
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TABLE  2-5 

ERRDSP  ERROR  AND  ADVISORY  MESSAGES 


***TAPE  READ  ERROR  ON  IMAGERY  INPUT  TAPE— MT *** 

★★*EU  PROCESSING  STOPPED-EOF  OR  EOT  REACHED — MT *** 

***EOT  OR  EOF  REACHED  AFTER  READING  HEADER--MT *** 

***HEADER  TAPE  OUTPUT  ERROR— MT *** 

***TAPE  WRITE  ERROR— MT *** 

***JOB  ABORTED-TAPE  READ  ERROR  ON  1ST  DATA  SET— MT__*** 

***JOB  ABORTED-TAPE  READ  ERROR  ON  HDR— MT *** 

***EOT  DETECTED;  REGISTRATION  TERMINATED— MT__*** 
★★★INVALID  IR  CHANNEL  TAG-CHANNEL  ZEROED*** 

***INVALID  VIS  CHANNEL  TAG-CHANMEL  ZEROED*** 

***SCAN  COUNT  DECREMENTED-PROCESSING  ABORTED*** 
***INVALID  CHANNEL  TAG-CHANNEL  ZEROED*** 

***TIME  DISCONTINUITY*** 

***INVALID  THUMBWHEEL  OPERATOR  INTERRUPT*** 

***INVALID  INPUT  TAPE-MOUNT  CORRECT  TAPE,  TYPE  'CON' 
***COMPLETED  EU  PROCESSING*** 

**DISK  ALLOCATION  ERROR  ON  COEF.  FILE  OUTPUT 
**DISK  ALLOCATION  ERROR  ON  COEF.  FILE  INPUT 
***EXCESSIVE  ROTATION;  JOB  ABORTED 
★**NO  DATA  FOUND  IN  EPHEMERIS  DISK  FILE 
***DISK  FILE  ALLOCATION  ERROR;  JOB  ABORTED 
***HEADER  DISK  FILE  WRITE  ERROR;  JOB  ABORTED 
***DATA  DISK  FILE  ERROR;  JOB  ABORTED 
***EXCESS.  TRANSLATION;  ZERO  FILL  FOR  THIS  PASS 
***REGISTRATION  PHASE  IN  PROGRESS*** 

***DISPLAY  TIMEOUT  FAILURE- JOB  ABORTED 
***EMISSIVITY  DISK  FILE  READ  ERROR;  JOB  ABORTED*** 
***SKIP  PROCESSING-COMPLETE  IR  OUTPUT  OF  ZERO  FILL 
***SKIP  PROCESSING-COMPLETE  VIS  OUTPUT  OF  ZERO  FILL 
**DISK  READ  ERROR-NOT  ABLE  TO  READ  COEFFICIENTS 
**DISK  WRITE  ERROR-COEFFICIENTS  NOT  SAVED  ON  DISK 
***COMPLETED  DAY  IR  CHANNEL  REGISTRATION 
★^COMPLETES 'REGISTRATION  PHASE_ 
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command  bloc*  contains  information  used  ^ 

address  “f  Jhe  “pUf  r e^Ss„  outputs  the  message  on  the  VT05 
messages,  and  the  torma  • FRRDSp  calls  IWRITE  to  log  the  same 

screen  and  return,  to  is  a FORTRAN  subrou- 

output  message  on  the  p^ERRDSP  CPC  since  I/O  interfaces  with 

tine  and  is  included  in  the  ERRDSP  CPC  sine  / FORTRAN  rou- 

tHe  ^than'the^are'from^an^assembiy0 routine  means  of  a WRITE  state- 
ment. ERRDSP  then  returns  control  to  the  calling  routine. 

Since  ERRDSP  is  used  purely  in  * s® "toe  capacity, ^any  CPC  l°aited 

module  in  the  SEDS  “ ^hl  set  Up  as  a load 

to  any  one  program  such  as  SEU,  SRE , etc. 

module  to  be  accessed  by  there  is 

in  with  other  routines  in  a particular  1 . letter 

enough  free  core  in  thads*°®g  “ufficien^t^cal^ERRDSP.  As  will 

beaS^t:ddineCtheC:ection  on  SRE  the  BKMSP  "^AHnableT 

load*  module 'to0 1 in^BRRDSP  in  with  it  or  call  ERRDSP  load  module 

via  a SEG  call* 


2. 2.5.2 


Flow  Charts.  See  the  following  five  pages. 
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2.2.  5.3  Interfaces 

A.  Input . The  only  input  data  to  ERRDSP  is  the  error  data 
common  in  RESIDENT,  set  up  by  the  calling  routine,  COMMON/ 
ERROR/IERR,  IUNIT.  IERR  is  a 16-bit  integer  word  represent 
ing  an  error  code  of  1-300,  while  IUNIT  is  a 16-bit  integer 
word  containing  the  unit  number  on  which  the  error  occurred 
set  up  only  if  applicable. 

B.  Output . The  output  data  from  ERRDSP  is  a command  block  and 
the  formatted  message  to  be  displayed  via  VT05H  on  the  VT05 

C.  Subroutines . The  subroutines  called  by  ERRDSP  CPC  are  ERR- 
DRV , ERRDSP  MAIN,  IWRITE,  AND  VT05H . These  are  discussed 
in  paragraph  2. 2. 5.1. 

D.  Called.  ERRDSP  is  called  by  any  CPC  in  the  SEDS  system 
that  requires  the  VT05  message  displaying  services.  The 
call  is  made  by  a SEG  call  to  the  load  module  or  by  a JSR 
or  CALL  Statement  from  a module  that  has  ERRDSP  linked  to 
it . 

2.2. 5. 4 Data  Organization.  ERRDSP  contains  unique  data  items  and 
tables  defined  internally  and  contained  within  its  subcomponents. 
This  data  is  for  purposes  of  being  accessed  and  used  only  by  those 
routines  contained  in  the  ERRDSP  CPC. 

A.  VTMSG$ . This  is  the  command  block  passed  to  VT05H  describ- 
ing the  output  requested.  It  is  formatted  as  follows. 


BYTE  1 

BYTE  0 

VTMSG$ : +0 

OUTPUT  REQUEST 

SPARE 

+ 2' 

COL  NO. 

LINE  NO. 

+4  ' 

ADR  (MSGBUF)  OF  OUTPUT  MSG  BUFFER 

B.  MSGBUF.  This  is  the  output  buffer  table  of  58^q  bytes. 
The  canned  message  is  placed  in  this  buffer  for  output 
by  VT05H. 
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C.  MSGTB1.  This  is  a predetermined  table  of  addresses  for 
the  messages  with  codes  of  1-99.  ERRDSP  uses  the  error 
code  value  as  an  index  into  this  table  to  set  the  address 
of  the  message  to  be  displayed.  The  format  is  as  follows. 


ADR  OF  MSG  1 
ADR  OF  MSG  2 
ADR  OF  MSG  3 

JaDR  OF  MSG  99~|" 


D.  MSGTB2.  This  is  a predetermined  table  of  addresses  for  the 
messages  with  codes  of  100-300.  ERRDSP  first  subtracts 
lOO^o  from  the  code  and  uses  it  as  an  index  into  this  table. 
The  format  is  as  follows. 


ADR 

OF 

MSG 

100 

ADR 

OF 

MSG 

101 

ADR 

OF 

MSG 

102 

^4 

ADR 

OF 

MSG 

3001 

E .  MSG1,  MSG2,  MSG3 , Etc.  Contained  within  the  ERRDSP  MAIN 
routine,  these  are  the  ASCII  character  strings  of  canned 
messages  with  the  labels  MSG  1 through  MSG  99  and  MSG  100 
through  MSG  300.  Each  message  is  terminated  with  a line 
feed  (LF)  character  in  the  ASCII  string. 


2. 2. 5. 5 Limitations . When  ERRDSP  is  called  via  SEG,  since  it  is 

a multiuser  program,  it  has  no  way  of  knowing  what  the  calling  pro- 
gram is.  Therefore,  it  exits  via  SEG  to  the  resident  routine. 

This  limitation  requires  careful  attention  when  using  ERRDSP  to 
output  an  advisory  or  error  message  when  the  user  wishes  to  con- 
tinue at  the  next  instruction  after  the  SEG  call. 

2.2. 5.6  Listings . See  Part  IV  of  this  document  published  under 
separate  cover. 
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SECTION  3 

SEDS  IMAGE  REGISTRATION  PROGRAM  (SRE) 

3.1  GENERAL  PROGRAM  CHARACTERISTICS 

SRE  is  the  program  of  SEDS  which  is  responsible  for  the  image 
registration  of  the  EU  converted  NOAA-satellite  data  output  from 
the  SEU  Program.  In  general,  this  involves  inputting  an  EU  pro- 
cessed tape  and  "mapping”  the  data  image  to  a predefined  SEDS 
reference  grid  of  Mexico.  This  registration  process  consists  of 
four  steps  as  follows. 

A.  Locating  preassigned  ground  control  points  from  the  input 
image  to  provide  a means  of  obtaining  coefficients  for 
mapping  the  image  to  the  reference  grid. 

B.  Coarse-rotating  the  image,  if  the  EU  tape  is  a night  pass, 
to  conform  to  a day  pass. 

C.  Using  the  mapping  coefficients  to  determine  the  amount  of 
scaling,  translation,  and  rotation  needed  to  apply  to  the 
data  in  order  to  achieve  correct  registration. 

D.  Building  a registered  disk  file  with  the  night  IR,  day  IR 
and  visible  channels  of  registered  data. 

The  SRIi  Program  also  provides,  as  optional  output  products,  a 
registered  IR  tape  and  isothermal  Images. 

Mapping  coefficients  used  to  register  the  data  are  obtained  during 
an  initial  phase  of  SRE  referred  to  as  the  GCP  phase.  The  operator 
is  provided  a means  of  screening  the  input  tape  and  manually  se- 
lecting ground  control  points  (GCP's)  recognized  in  the  image. 

These  key  points  relate  to  the  coordinate  points  in  the  reference 
grid  image.  By  using  these  corresponding  sets  of  coordinates  in 
the  two  images,  coefficients  are  calculated  for  mapping  one  image 
to  the  other. 
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For  a night  pass  tape,  the  SRE  Program  enters  a separate  phase  of 
processing  where  the  data  is  rotated  clockwise  25.8  degrees  and 
the  scans  and  PIXEL f s reversed.  This  is  done  prior  to  e ac 
registration  so  that  the  image  looks  like  a day  pass. 

The  last  step  of  SRE  is  the  registration  of  the  image.  One  by 
, t crans  are  read  from  tape  into  a buffer  m core.  The 
translation  and  scaling  is  performed  on  each  scan  as  indicated^ 
hv  specific  mapping  coefficients.  This  continues  until  the 
auired  number  of  scans  have  been  placed  in  the  buffer  to  begin 
rotation  (resectioning)  of  the  -corrected”  data.  A precomputed 
k PTYFI  ' s is  extracted  from  each  scan  m the  buffer 

build  one  ouStt  Registered"  scan.  This  scan  is  then  written 
to  the  registered  disk  file  which  will  eventually  contain  t e 
entire  Registered  image,  and  will  be  used  as  input  to  the  RAP 

Program. 

Since  SRE  is  a complex  program,  we  will  refer  to  each  unique  phase 
of  the  registration  processing  as  a computer  program  component 
(CPC).  There  are  essentially  three  phases  of  SRE  as  outlm 

previously : 

• Initialization  and  GCP  phase 

• Night  coarse  rotation  phase 

• Data  image  registration  and  disk  build  phase. 

SRE  is  broken  down  into  three  memory  mapping  conf: lgUp!Rh°MM Rcon^ 

^-nCsTf  RSHnd  n 

4at  perform  the  functions  of^RE^ 

naming  in  the  MMC  via  CALL  NEWMMC  (’AAA').  This  sets  up 
the  memory  mapping  for  a particular  MMC  in  core  Next  ^ 
mil  is  made  to  give  program  control  to  a specific 
within  that  MMC  by  CALL  SEG  ( ’XXXXXX.LDA’ ,N ,N) . Figure  3-1  rep- 
regents  Rhe  MMC  layout  of  tta  SRE  Program  and  the  load  modules  of 

each  MMC. 
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Figure  3-1  SRE  Program  Unit 
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The  three  major  CPC’s  and  the  phase  of  processing  performed  by 
each  are: 

• SRC  CPC  - Initialization,  job  setup,  GPC  processing 

• ROT  CPC  - Night  coarse  rotation  of  data  to  prepare  image 
for  registration 

• REG  CPC  - Data  image  registration  to  include  translation 
and  scaling  corrections  and  rotation  (resectioning)  of  the 
data  to  register  it  to  a predefined  reference  grid. 

3.1.1  Functional  Allocation.  As  stated  in  the  PHO-TN734,  SRC 
performs  the  image  registration  requirement  of  mapping  NOAA  satel- 
lite day  pass  or  rectified  night  pass  data  onto  the  SEDS  reference 
grid.  In  mapping  the  data,  a Lambert  Conformal  Conic  projection 
map  is  utilized  as  a reference  grid.  The  registration  of  an  image 
data  array  (E,S)  from  the  NOAA  satellite  to  the  planar  reference 
gpxd  coordinates  (X,Y)  is  accomplished  via  six  remapping  coeffi 
cients.  These  coefficients  are  calculated  during  the  GCP  phase 
(SRE  CPC),  The  coefficients  include  translational  scaling  and 
rotational  corrections.  A ’’least- squares  fit”  approach  is  used 
to  determine  these  coefficients  by  locating  a sufficient  number 
of  GCP’s.  The  location  of  GCP ' s from  the  IR  data  is  accomplished 
by  use  of  the  interactive  color  display  (ICD)  system.  Image  data 
is  output  to  the  ICD  and  the  operator  can  identify  key  points  in 
the  image  by  a manual  capability  (discussed  in  paragraph  3.2.1). 
The  (E  ,S)  coordinate  of  the  identified  point  is  determined  and  the 
corresponding  (X,Y)  point  in  the  reference  grid  is  picked  up  to 
perform  a fit  of  (E,S)  ■+  (X,Y).  For  night  data,  each  identified 
GCP  (E,S)  is  first  rotated  through  a predetermined  angle  to  re- 
flect it  in  the  day  pass  coordinate  plane.  This  is  necessary 
since  the  calculations  for  determining  the  coefficients  are  done 
on  the  assumption  that  coordinates  of  points  be  in  the  day  pass 
coordinate  plane.  Now  the  mapping  coefficients  are  computed  us- 
ing all  GCP's  identified.  Statistics  on  the  GCP’s  located,  their 
fit,  and  the  mapping  coefficients  are  displayed  on  the  VT05  for 
GCP  identification  accuracy  and  to  determine  when  enough  points 
have  been  located.  The  GCP  phase  is  terminated  via  the  operator 
when  a sufficient  number  of  points  have  been  identified  and  the 
coefficients  are  approximately  what  they  should  be  for  a correct 

fit . 
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If  the  data  is  a night  pass  image,  the  program  enters  the  night 
coarse  rotation  phase  (ROT  CPC).  The  input  data  is  first  com- 
pressed 4 to  1 in  each  direction  by  averaging  4x4  PIXEL  arrays 
together.  The  compressed  image  is  output  to  disk  and  read  back 
in  reverse  scan  line  order  into  a buffer.  The  image  is  rotated 
25.8  degrees  clockwise  by  resectioning  buffered  lines  at  that 
angle,  creating  rotated  compressed  scan  lines.  In  each  scan  line 
prior  to  output,  the  PIXEL'S  are  reversed;  and  the  entire  image 
is  decompressed  1 to  4 by  repeating  PIXEL'S  and  scan  lines  four 
times  each.  Each  resultant  scan  line  is  written  to  a 9-track 
CCT  (CRT  tape)  to  be  used  as  input  to  the  registeration  phase. 

The  program  next  enters  the  actual  registration  phase  (REG) . The 
remapping  coefficients  obtained  during  the  GCP  phase  are  applied 
to  map  the  input  image  array  (E,S)  to  the  reference  grid  array 
(X , Y) , as  follows : 

X * A1  + A2E  + A3S 
Y - B1  + V + B3E 

Where: 

(A^,B^)  = translational  corrections 
(A2,B2)  = scaling  corrections 
(A^.B^)  = rotation;!  1 corrections 

"Nearest  neighbor"  radiometric  value  assignments  are  used  to  map 
the  input  PIXEL’S  to  the  reference  grid  locations.  The  scaling  and 
translational  corrections  are  applied  to  each  scan  line  as  it  is 
input  for  the  registration  pass.  An  adequate  number  of  corrected 
scan  lines  are  then  buffered  so  that  they  can  be  resectioned  at 
an  angle  as  indicated  by  the  rotational  correction  coefficient. 
These  resectioned  scan  lines  are  now  registered  to  the  reference 
grid  and  are  output  to  the  registered  disk  file.  Figures  3-2 
through  3-4  are  graphic  portrayals  of  the  general  functions  of 
each  CPC  of  SRE. 

3.1.2  Program  Flow  Chart.  See  figure  3-5. 
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Figure  3-2  SRE  (CPC  No.  2)  Basic  Configuration 


Figure  3-3  ROT  (CPC  No.  2)  Basic  Configuration. 
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Figure  3-4  REG  (CPC  No.  3)  Basic  Configuration 
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Figure  3-5  General  Program  Flow 


JSC-10019 
Part  II 


3#1#3  Timing  and  Sequencing.  As  the  SRE  Program  unit  is  called 
Up  for  the  registration  processing  following  SEU,  program  control 
is  given  to  the  SRE  CPC  for  initialization  and  job  setup.  The 
SRE  CPC's  interface  with  the  VT05  handlers  to  output  registera- 
tion  initialization  displays  and  handle  operator  inputs.  The 
mapping  coefficients  can  be  entered  via  cards  or  from  disk  stor- 
age in  cases  of  job  returns.  In  this  case,  the  coefficients  are 
entered  into  the  system  and  a tabout  is  output  to  the  line  printer 
containing  the  input  coefficients.  The  SRE  CPC  then  returns  to 
the  SEDS  resident  routine  to  proceed  to  the  next  appropriate  phase. 
If  this  is  not  a rerun,  the  SRE  CPC  enters  the  GCP  phase  where  it 
interfaces  with  the  VT05  and  the  ICD  system  to  provide  screening 
of  the  data  and  the  location  of  GCP ' s via  the  operator.  This 
involves  a multipass  screening  to  enable  receiving  the  entire 
image.  The  sequence  consists  of  reading  a scan  of  IR  data  from 
the  EU  input  tape  and  interfacing  with  a routine  which  schedules 
an  interrupt -driven  routine  to  output  the  scan  line  data  to  the 
ICD.  The  SRE  CPC  routine  must  wait  for  a complete  flag  before 
proceeding  to  the  next  scan  line.  The  GCP  process  cannot  be  def- 
initely time-tagged,  because  it  depends  on  the  number  of  passes 
necessary  to  view  the  image  and  collect  enough  points  for  adequate 
registration.  The  operator  is  able  to  halt  temporarily  the  screen- 
ing of  the  data  to  identify  GCP's.  For  each  identified  point, 
the  SRE  CPC  computes  a "fit,"  mapping  coefficients,  and  other 
statistics.  This  data  is  then  refreshed  on  the  VT05  display  via 
the  VT05  routines.  When  finished  with  the  GCP  phase,  the  SRE  CPC 
returns  to  the  SEDS  resident  routine  for  the  next  phase  of  the 
registration  program  to  be  called  up. 


If  this  is  a day  pass,  the  SEDS  resident  routine  calls  in  the  REG 
CPC  modules  to  begin  registration  processing.  If  this  is  a night 
pass,  the  SEDS  resident  routine  calls  in  the  ROT  CPC  modules  to 
perform  the  night  coarse  rotation.  ROT  modules  interface  with 
NT RAN  to  accomplish  the  necessary  tape  and  disk  I/O.  As  each  scan 
is  read  in  from  the  EU  input  tape,  each  set  of  four  PIXEL'S  is 
averaged,  as  well  as  each  set  of  four  scans.  The  compressed  scans 
are  written  to  disk.  When  the  program  is  finished  with  all  scans, 
the  compressed  data  on  disk  is  read  back  into  a core  buffer  in 
reverse  order;  (i.e.,  scan  lines  reversed).  The  data  is  resec- 
tioned  (rotated),  PIXEL'S  reversed,  decompressed  and  written  out  to 
tape  This  tape  is  to  be  used  in  the  last  phase  of  SRE  as  the 
input  to  registration.  ROT  CPC  returns  to  the  SEDS  resident  rou- 
tine to  call  up  the  registration  processing  modules  (REG  CPLj. 

The  night  coarse  rotation  phase  takes  approximately  15- 
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REG  CPC  modules  now  perform  the  registration  of  the  input  data 
(EU  or  CRT  tape) . Each  scan  is  read  into  core  via  the  NTRAN 
tape  I/O  routine  and  scaling  and  translational  corrections  are 
done.  The  corrected  scan  is  put  into  the  rotation  buffer,  where 
resectioned  scan  lines  are  taken  out  to  build  a registered  scan 
for  output.  The  REG  CPC  then  writes  the  scan  to  the  disk  using 
the  NTRAN  disk  I/O  routine.  If  the  output  products  are  selected, 
the  REG  CPC  writes  the  scan  to  the  IR  tape  via  NTRAN  and  inter- 
faces with  the  product  generator  routines  (paragraph  5.2.3)  to 
build  the  isothermal  products.  The  REG  phase  takes  approximately 
40-50  minutes  for  a day  pass,  which  includes  visible  and  IR 
channels,  and  approximately  27  minutes  for  a night  pass,  which 
includes  only  the  IR  channel.  However,  if  no  output  products  are 
requested,  the  execution  time  is  significantly  reduced.  The  in- 
terfacing and  output  to  the  ICD  for  isothermal  products  uses  a 
significant  amount  of  CPU  time,  since  there  is  a "wait-for- 
completion"  for  each  scan  line  output. 

3.1.4  Storage  Allocation.  Figures  3-6  through  3-11  represent 
graphically  the  storage  allocations  of  the  SRE  Program.  Also 
illustrated  are  the  physical  and  virtual  core  layouts  of  each 
CPC  (or  memory  map  configuration) . 

The  virtual  core  layout  represents  each  32K  load  module  within 
each  CPC.  During  program  execution,  only  32K  of  core  can  be 
accessed  at  any  one  time.  That  is  the  reason  for  the  division 
of  MMC’s  into  load  modules  when  the  MMC  unit  is  too  large  for 
32K.  Each  MMC  or  CPC  represents  a 128K  physical  core  map.  SRE 
has  three  MMCfs,  since  the  entire  SRE  Program  unit  is  larger  than 
I 28K . In  a given  MMC  (e.g.,  REG),  when  the  program  and  data  core 
required  is  greater  than  128K,  the  MMC  resorts  to  an  overlay 
scheme.  Load  modules  having  the  same  extensions  are  potential 
overlays  should  the  core  required  for  an  MMC  be  greater  than  the 
128K  available  physical  core  of  the  PDP  11/45,  Of  these  load 
modules  with  the  same  extension,  the  largest  one  is  set  in  physi- 
cal core  to  allocate  the  necessary  memory  space.  The  overlay  load 
modules  are  stored  on  disk.  When  needed  for  program  execution, 
the  load  module  is  read  from  disk  by  SEG  and  placed  in  physical 
core,  overlaying  the  load  module  of  the  same  extension.  The  load 
module  previously  residing  in  physical  core  is  saved  on  disk. 
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Figure  3-8  ROT  CPC  32K  Virtual  Core  Allocation 
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This  overlay  system,  with  the  swapping  of  load  modules  in  and  out 
of  core,  is  a time-consuming  process,  so  one  should  be  very  care- 
ful in.  selecting  potential  overlays.  For  the  case  in  REG  CPC,  the 
load  module  selected  as  an  overlay  is  called  at  the  very  first 
of  the  registration  processing  to  build  the  output  headers  and  is 
called  only  once  during  an  entire  SRE  Program  run. 

If  a data  module  is  set  up  in  a virtual  core  layout  with  a load 
module,  it  is  mapped  in  with  the  load  module  via  a SEG  call  at 
140000  or  24-28K.  The  resident  and  DOS  area  at  0-12K  (0-57777) 
is  never  altered  or  overlayed,  nor  is  SEG  at  28-32K  or  160000- 
177777.  The  program  load  modules  are  always  mapped  in  beginning 
at  60000  (12K  to  24K) . 

Data  modules  can  also  be  mapped  in  separately  by  a call  to  SEG, 
which  results  in  the  data  module  being  mapped  at  24-28K  while 
no  other  areas  of  the  32K  core  map  are  altered 

3,1.5  Data  Base  Characteristics.  The  data  base  of  the  SRE  Pro- 
gram consists  of  data  modules,  a common  data  area  and  data  con- 
tained in  individual  routines  or  load  modules. 

As  discussed  previously,  data  modules  (4K  blocks)  are  associated 
with  load  modules  or  they  can  be  mapped  in  by  themselves  at  24- 
28K.  This  provides  for  a transfer  of  data  from  one  load  module 
to  another  in  a CPC. 

A common  data  area  resides  in  the  SEDS  resident  module,  which  can 
be  accessed  by  all  CPC’s  (MMC's)  and  load  modules.  That  way,  data 
flags  can  be  referenced  by  all  programs  during  a job,  since  the 
resident  area  (at  0-12K)  is  never  overlayed  or  remapped. 

The  data  residing  in  individual  routines  within  CPC’s  will  be 
discussed  in  paragraphs  3. 2. 1.4,  3. 2. 2. 4,  and  3. 2. 3. 4,  called 
’’Data  Organization."  Also  refer  to  these  paragraphs  for  descrip- 
tions of  the  data  modules  of  each  CPC.  Since  the  CPC’s  are  broken 
down  into  various  MMC’s,  each  has  a unique  data  base,  so  the  de- 
scription of  the  entire  data  bases  will  not  be  done  in  this  section. 
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Below  is  a list  of  tables,  items  and  data  words  in  the  resident 
common  area  associated  with  the  SRE  Program: 

A.  COMMON/ GCOEFF/ . This  common  is  set  up  during  the  GCP  phase 

by  the  SRE  CPC  to  be  used  during  registration  by  the  REG 

CPC. 

!•  Al>  A2,  A5 » B2,  B3,  RAx,  RA2,  RA3 , RBj,  RB2 , RB3 . 

These  are  mapping  and  inverse  mapping  coefficients 
(two  words  allocated  for  each  floating  point  data  word) . 

2.  I1SCAN.  Start  scan  number  (one  16-bit  word). 

3.  ISCLST.  Stop  scan  number  (one  16-bit  word) . 

4.  IPXONE . Start  PIXEL  number  (one  16-bit  word). 

5.  IPXLST.  Last  PIXEL  number  (one  16-bit  word). 

6.  ICNTSN.  Center  scan  (one  16-bit  word). 

7.  I CNTPX . Center  PIXEL  (one  16-bit  word). 

8.  EBAR,  SBAR.  Input  image  average  values  (each  two  words 
in  floating  point) . 

9.  XBAR,  YBAR.  Reference  grid  average  values  (each  two 
words  in  floating  point) . 

10.  NUMGCP . Number  of  GCP 1 s identified  during  screening 
pa  ss , 

B.  COMMON/SEDCOM/ . This  common  is  used  and  set  during  all 

phases  of  the  registration. 

1.  INIT . Termination  flag  (0  = initialization,  1 = con- 
tinue processing,  2 = terminate  this  phase  of  SEDS 
processing,  -1  = finished  day  IR  registration  -- 
proceed  to  day  visible  registration). 
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2. 


IPASS.  Night/day/restart 
1 = night  registration, 
coarse  rotation,  3 = day 


flag  (0  = day  registration, 

2 = night  restart  after 
restart  after  IR  registration. 


C. 


D. 


E. 


3.  IRST.  Restart  flag. 

4.  ISCRN.  GCP  screening  option  flag  used  by  RGDISP 
(SRE  CPC) . 

COMMON/ PRFLGS/.  This  contains  three  flag  words  of  16  bits 
each. 

1.  ISOTPE.  Isothermal  output  tape  selection  (0  or  1). 

2.  ISODSP.  Isothermal  color  display  selection  (0  or  1) . 

3.  IRTAPE.  IR  registered  tape  selection  (0  or  1). 

COMMON / CORN RS/.  This  common  contains  four  16-bit  integer^ 
words  --  ICAT  ICB , ICC,  and  ICD,  which  are  coordinates  of 
the  four  corners  of  the  reference  grid. 

COMMON / TAPE ID/.  This  common  is  set  up  in  SRE  CPC  initiali 
zation  from  operator  entries  to  the  job  setup  display. 


1. 


IDINT.  Tape  ID  in  EBCDIC  for  the  night 
intermediate  tape  (five  16-bit  words,  e 


coarse  rotated 
g.,  CRT-XXXXXX) 


F. 


2 IDISO  Tape  ID  in  EBCDIC  for  the  isothermal  output 
Tape~(five  16-bit  words,  e.g.,  OID-XXXXXX) 

3.  IDREG.  Tape  ID  in  EBCDIC  for  t*e™  registered  output 
tape*” (five  16-bit  words,  e.g.,  SMD-XXXXXX ,) 

COMMON / TP FRMT/.  This  common  is  set  up  by  the  REG  and  R0T^ 
CPC's  (module  REGHED)  from  the  input  tape  header  data, 
contains  seven  words. 


1,  IRCSET.  Records  per  data  set. 

2.  IRCSZE.  Record  size. 
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3. 

IANCSZ . 

Ancillary  size. 

4. 

IFSPIX. 

Start  PIXEL  on  tape. 

5. 

IENPIX. 

End  PIXEL  on  tape. 

6. 

ICHSZE. 

Total  bytes  per  scan  per  channel. 

7. 

ICH1ST. 

set. 

Number  of  channels  in  first  record  of  data 

G.  COMMON/ SCOMVT/.  This  common  contains  flag  words  set  by  the 
VTO 5 resident  program  on  receiving  operator  VT05  command 

inputs . 

The  rest  of  this  common  contains  data  words  set  up  from 
the  input  header  information  by  U9TRD. 


. CSECT 

SCOMVT 

PROGID: 

. BLKW 

1 

DAY: 

. BLKW 

1 

MONTH: 

. BLKW 

2 

YEAR: 

.BLKW 

1 

INTFLG: 

.BLKW 

1 

GOFLAG: 

.BLKW 

1 

ADVFLG: 

.BLKW 

1 

BCKFLG : 

.BLKW 

1 

CONFLG : 

.BLKW 

1 

DSPFLG : 

.BLKW 

1 

END  FLG : 

.BLKW 

1 

HDCFLG : 

.BLKW 

1 

KILFLG: 

.BLKW 

1 

RSTFLG : 

.BLKW 

1 

REWFLG: 

.BLKW 

1 

HLTFLG : 

.BLKW 

1 

ABTFLG: 

.BLKW 

1 

.BLKW 

82. 

i RESERVED  STORAGE  FOR 

CURRENT  ANCILLARY  BLOCK. 

CURRENT 

ANMSSI : 

.WORD 

0 

; BYTES  1 &2  OF  TIME  FROM 
ANCILLARY  BLK 

ANLSSI : 

.WORD 

0 

; BYTES  3&4  OF  TIME  FROM 
ANCILLARY  BLK 

CURRENT 

SLNO : 

.WORD 

0 

; CURRENT  SCAN  LINE  NBR 
ANCILLARY  BLK 

FROM 
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; RESERVED  STORAGE  FOR  HEADER  RECORD  INFORMATION 


CS  ID 

.BLKW 

16. 

9 

TLID 

.BLKW 

10. 

• 

9 

SNID 

.WORD 

0,0, 0,0 

9 

TGDT 

.WORD 

0,0,0 

9 

TSNO 

.WORD 

0 

9 

T1ST 

.WORD 

0,0, 0,0, 0,0,0 

9 

CACT 

.WORD 

0 ,0  ,0  ,0 

9 

PRFL 

.WORD 

0 

• 

9 

NOCH 

.WORD 

0 

9 

NOBP 

.WORD 

0 

9 

VADR- 

.WORD 

0 

;( 

CADR: 

.WORD 

0 

• 

9 

NOVE 

.WORD 

0 

9 

NOCE 

.WORD 

0 

9 

RSI  Z 

.WORD 

0 

9 

OPRR 

J 

.WORD 

0 

• 

9 

PRPC 

• 

9 

.WORD 

0 

• 

9 

RPRS 

, WORD 

0 

9 

ANCL 

.WORD 

0 

• 

9 

DORD 

.WORD 

0 

9 

FPNO 

.WORD 

0 

9 

LPNO 

.WORD 

0 

• 

9 

SPRR 

.WORD 

0 

• 

9 

CANL 

.WORD 

0 

9 

.BLKW 

26. 

9 

CURSLN : .WORD 

0 

9 

.BLKW 

12. 

9 

RORBIT:  . BLKW 

1 

9 

RDATE : .BLKW 

3 

• 

9 

(1-32)  COMPUTING  SYSTEM  ID 
(33-52)  TAPE  LIBRARY  ID 
(53-60)  SENSOR  ID 

(61-63)  DATE  OF  THIS  TAPE  GENERATION 
(64)  TAPE  SEQUENCE  NO. 

(73-80)  TIME  OF  FIRST  SCAN  ON  TAPE 
(81-88)  CHANNELS  ACTIVE  ON  TAPE 

(89)  PROCESSING  FLAG  (1=PR0C, 

0=  RAW ) 

(90)  NBR  CHANNELS  ON  TAPE 

(91)  NBR  BITS/PIXEL 

92-93)  ADR  OF  START  OF  VIDEO  DATA 
W/I  CHANNEL 

(94-95)  ADR  OF  START  OF  CAL  DATA 
W/I  CHANNEL 

(96-97)  NBR  PIXELS/SCAN/CHANNEL 
(98-99)  NBR  CAL  ELEMENTS/SCAN/ 
CHANNEL 

(100-101)  RECORD  SIZE  IN  BYTES 

(102)  NBR  CHANNELS/RECORDIN  2ND, 

AND  SUB,  REC ,=0 , IF  PIXELS/  » 
CHANNEL<3K 

(103)  NBR  REC/SCAN/CHANNEL  =0 
UNLESS  NBR  OF  PIXELS/ 
CHANNEL<3K 

(104)  NBR  RECORDS  TO  MAKE  A 
COMPLETE  DATA  SET 

(105-106)  LENGTH  OF  ANCILLARY 
BLOCK  IN  BYTES 

(107)  DATA  ORDER  INDICATOR  (0* 

CHAN,  1 =P I XE  L ) 

(108-109)  START  PIXEL  NBR 
(110-111)  STOP  PIXEL  NBR 
(1778)  NBR  DATA  SETS  PER  RECORD 
(1785-1786)  NBR  CHANNELS  IN  THE 
PHYSICAL  RECORD 

FILL 

CURRENT  SCAN  LINE  NBR 
FILL 

ORBIT  NBR 
DATE  OF  DATA 
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2.2  SRE  CPC  Characteristics.  The  following  paragraphs  contain  de- 
tailed descriptions  of  the  three  CPC’s  outlined  in  paragraph  3.1. 
The  instruction  listing  contained  herein,  by  inclusion  or  ref- 
erence, specifies  the  exact  configuration  of  the  SRE  Program. 

Each  CPC  will  be  discussed  individually  in  the  following  para- 
graphs as  SRE  (CPC  No.  1),  ROT  [CPC  No.  2),  and  REG  (CPC  No.  3). 

3.2.1  SRE  (CPD  No . 1) . The  SRE  CPC  performs  the  initialization 
setup  and  GCP  processing.  It  is  the  first  CPC  to  receive  program 
control  after  the  SRE  Program  is  called  up  via  the  operator. 

The  SRE  CPC  consists  of  eight  load  modules;  six  of  these  are  made 
up  primarily  of  assembly  language  routines,  while  the  other  two 
are  primarily  in  FORTRAN  with  some  assembly  language.  See  figure 
3-6  for  a graphic  core  layout  of  the  SRE  CPC  and  its  load  modules. 
Some  of  the  major  functional  interfaces  include  interfacing  with 
U9TRD  (universal  read  routine)  and  DISPL  to  perform  the  screening 
of  the  input  tape  on  the  ICD  during  GCP  identification.  Other 
interfaces  include  VT05  displays  and  operator  communication  for 
job  setup  via  the  resident  VT05  handlers  and  routines  (VT05H,  VTIN, 
VTOUT,  SPCMD,  and  VTLINK) . Disk  and  tape  I/O  is  accomplished  via 
NT RAN , a resident  routine  that  performs  requested  DOS  I/O. 

3.2.1. 1 Description.  This  paragraph  discusses  in  detail  the 
actual  design  flow  and  functions  of  the  SRE  CPC,  including  the  role 
each  of  the  eight  load  modules  performs  to  carry  out  these  func- 
tions. Topics  discussed  are,  in  order  of  discussion,  load  modules, 
program  flow,  the  GCP  display,  and  the  GCP  tabout. 

3. 2. 1.1.1  Load  Modules.  The  SRE  CPC  consists  of  eight  load 
modules,  each  comprising  a 32K  virtual  core  map;  they  are  mapped 
in  by  a call  to  SEG  when  required  for  a specific  phase  of  GCP  or 
Initialization  processing.  They  are  listed  below. 

• RGDISP 

• DAYRG1 

• DAYRG2 

• NITRG1 


C 3 
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• NITRG2 
9 GCPID 


• GCPEXC 


CURDS P 


A brief  description  of  the  load  modules  and  subroutines  follows. 


A. 


RGDISP  This  is  the  main  controller  load  module,  which 
set s~up  the  initial  job  and  calls  the  other  load  modules 
as  necessary.  It  is  also  responsible  for  providing  a_ 
statistical  data  tabulation  of  the  GCP  phase  and  retrieval 
and/or  storage  of  the  mapping  coefficients  on  disk.  RGDIS 
controls  the  program  flow  for  all  of  the  initialization 
setup  phase  of  SRE.  Its  routines  and  subroutines  are  as 

follows . 


1.  INTDSP.  Outputs  initial  registration  display 
(assembly) . 

2.  GCPCHK.  Provides  display  via  COFDSP  of  coefficients 
computed  during  GCP  phase  and  a means  of  changing 
them  at  the  end  of  the  GCP  phase  (assembly) . 

3.  COEFCK.  On  GCP  phase  bypass,  respons ible ^f or  obtain- 
ing the  coefficients  from  disk  and/or  cards. 

4.  COFDSP.  An  assembly  routine  that  outputs  a display 
of  the  mapping  coefficients  taken  from  disk  storage 
or  those  just  calculated  in  the  GCP  phase;  enables 
the  operator  to  modify  the  entries  via  the  VI 05. 


'5.  STCIIEK.  Performs  status  checks  (assembly). 

6 CNVREL.  Converts  the  coefficients  on  the  display 

(COFDSP)  from  ASCII  to  real  values  and  moves  them  to 

the  GCOEFF  common. 


‘REPRODUCIBILITY  OP  THE 
.ORIGINAL  PAGE  IS  POOP 
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7.  CNVASC.  Converts  coefficients  as  in  the  GCOEFF 
common  from  floating  point  to  ASCII  for  purposes  of 
displaying  (FORTRAN) . 

8.  DSKIN , DSKOUT . Responsible  for  disk  I/O  involved  in 
retreiving  and  storing  coefficients  on  disk  (FORTRAN) . 

9.  CRDTAB . Coefficient  card  input  processor  (FORTRAN). 

10.  GCPSTT  and  TAB G CP . These  routines  tabulate  GCP 
statistics  at  the  completion  of  the  SRE  CPC  run 
(FORTRAN) . 

B.  DAYRG1 . Called  in  by  RGDISP  for  a normal  day  registration 
run.  It  outputs  a processing  display  to  the  VT05,  to 
which  the  operator  keys  in  processing  actions  and  output 
product  selection.  It  sets  up  common  flag  words  from  in- 
formation input  via  operator.  Its  routines  and  subroutines 
are  as  follows. 

1.  DAYRG1 . Main  routine  (assembly. 

2.  DATIT.  Retrieves  current  date  for  display  (assembly). 

3.  TAPES . Reads  header  data  from  EU  input  tape 
(assembly) . 

4.  CHEK.  Performs  EBCDIC- to-ASCI I conversion. 

5.  TPTIM.  Strips  date  of  data  from  header  for  STTIME 
common  (assembly). 

6.  VTUNK.  VT05  routine  used  to  output  display  to  VT05 
(assembly) . 

C.  DAYRG2 . This  module  is  the  same  as  DAYRG1  except  that  it 
is  for  a day  restart  run. 

D.  NITRG1.  This  module  is  the  same  as  DAYRG1  except  that  it 
is  for  a night  run. 
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E.  NITRG2 . This  module  is  the  same  as  DAYRG1  except  that  it 
is  for  a night  restart  after  coarse  rotation  run. 

F.  GCPID . This  module  is  called  by  RGDISP  when  the  GCP 
screening  phase  is  selected,  and  is  the  main  controller 
of  the  GCP  identification  process.  It  screens  input  data 
and  provides  operator  control  for  screening  selections  and 
identifying  points  in  the  image.  Its  routine  and  subrou- 
tines are  as  follows. 

1.  GCPID . Main  routine  (assembly). 

2.  PRCID . Routine  to  process  each  ID  selected;  calls 
GCPEXC  for  computations,  and  is  responsible  for  GCP 
display  (assembly) . 

3.  DISPL . Routine  which  interfaces  with  ICD  handler  to 
display  input  image. 

4.  U9TRD . Universal  9-track  tape  read/write  routine; 
reads  input  tape  (assembly). 

5.  NNCQDE.  Converts  display  outputs  from  floating  point 
to  ASCII  prior  to  be  output  to  GCP  display  (FORTRAN). 

6.  CNVTES . Computes  a corresponding  E£jS  in  the  input 
image  from  the  GCP  display  coordinates  XPOS  and  YPOS 
returned  in  the  ICD  monitor  packet  (FORTRAN) . 

7.  VTLINK.  VT05  routine  that  sets  up  a VT05  requested  dis- 
play. 

G.  GCPEXC.  This  module  is  called  by  the  GCPID  load  module 
for  each  GCP  identified  or  deleted.  It  is  responsible  for 
calculating  the  fit  of  the  GCP's  to  the  reference  grid 
points,  calculating  the  mapping  and  inverse  transforma- 
tion coefficients,  and  calculating  delta  errors  reflecting 
the  difference  between  where  the  point  was  located  via  the 
operator  and  where  the  point  was  computed  to  be.  Its 
routines  and  subroutines  are  as  follows. 

1.  GCPEXC.  Main  routine  (FORTRAN). 


3-26 


JSC-10019 
Part  II 


2.  GRDINT . Initializes  the  reference  grid  preassigned 
GCP  coordinates  (FORTRAN), 

3.  PMMGCP . Uses  ephemeris  data  to  calculate  longitude  and 
latitude  of  a point,  the  coordinates  of  which  are  E = 
1762,  S = center  scan;  finds  the  corresponding  ref- 
erence grid  coordinates  (FORTRAN) . 

4.  ROTE . Rotates  a point  (X,Y)  clockwise  through  25.8 
degrees  (FORTRAN) 

5.  ROTATE . Calculates  the  coarse  rotation  of  night  pass 
operato r- identi f ied  GCP’s;  GCP  represented  in  the  day 
pass  coordinate  field  (FORTRAN) . 

6.  INVROT.  Computes  the  inverse  of  the  projected  rotated 
points  (pre-image  points)  in  a night  pass  to  get  them 
back  in  the  night  coordinate  field  prior  to  calcu- 
lating the  delta  errors  (FORTRAN)  . 

7.  GCPNTS . Computes  the  pre-image  points  from  reference 
grid  coordinates.  Using  inverse  mapping  coefficients, 
it  obtains  the  calculated  GCP  coordinates  in  the  input 
image.  For  night  passes,  it  reflects  the  pre-image  in 
the  rotated  image  (FORTRAN) . 

8.  PHMPTS . Computes  the  ephemeris  generated  GCP’s  from 
the  reference  grid  coordinates  (FORTRAN) . 

9.  SUMSQR,  R1SUM , R2SUM , ISUMDX , and  RSUMDX.  These  sub- 
routines or  functions  compute  the  sums  of  squares, 
sums,  sums  of  two  arrays,  etc. 

H.  ERRDSP.  This  service  load  module  is  used  to  output  advisory 

or  error  messages  to  the  VT05  and  line  printer.  See  para- 
graph 2.2.5  for  a description  of  ERRDSP. 

3.2,1. 1.2  Program  Flow.  See  figure  3-12  for  the  general  SRE  CPC 
flow.  The  regis teration  programs  are  called  in  for  execution  by . 
the  operator  keying  in  the  mnemonic  SRE  on  the  YT05  SEDS  initiali- 
zation displays.  The  SEDS  resident  routine  then  maps  the  SRE 
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Figure  3-12  SRE  CPC  General  Flow 
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MMC  into  physical  core  and  gives  program  control  to  the  RGDISP 
load  module.  RGDISP  calls  the  subroutine  INTDSP  to  output  the 
registration  initialization  display  (see  figure  3^13)  to  the 
VT05  on  which  the  operator  selects  the  type  of  run,  (day,  night, 
day  restart,  night  restart).  Depending  on  the  run  selection 
keyed  in,  RGDISP  maps  in,  via  SEG,  the  appropriate  load  module 
(DAYRG1,  DAYRG2,  NITRG1,  or  NITRG2) . Each  of  the  four  load 
modules  has  a specific  processing  display  which  is  output  to  the 
VT05  (see  figures  3-14  through  3-17  for  the  display  formats) . 

The  purpose  of  this  display  is  to  enable  the  operator  to  set  the 
run  up  as  desired,  and  select  output  products  and  options  avail- 
able for  each  run.  Depending  on  the  options  selected,  the  load 
module  sets  flag  words  in  the  resident  data  common  to  be  used 
later  by  the  REG  CPC.  The  operator  also  keys  in  output  tape  ID’s 
which  are  to  be  put  in  the  tape  header  for  identification.  After 
all  entries  are  made,  RGDISP  is  called  back  in  for  control.  A 
check  is  made  to  determine  if  the  GCP  screening  option  was  se- 
lected. As  stated  previously,  the  GCP  phase  can  be  bypassed  as 
long  as  the  mapping  coefficients  can  be  entered  into  the  system. 
There  are  two  approaches  available  --  the  operator  can  input  the 
coefficients  via  cards,  or  the  coefficients  for  the  last  previ- 
ously run  day  and  night  registration  passes,  which  are  saved  on 
disk  for  purposes  of  retrieval  on  a restart,  can  be  used. 

RGDISP  calls  the  routine  COEFCK  to  determine  which  input  method 
is  to  be  used.  If  card  inputs  are  to  be  used,  COEFCK  calls  a 
FORTRAN  subroutine,  CRDTAB , to  read  the  cards,  set  up  the 
GCOEFF  common  with  the  input  data,  and  provide  a tabout  of  the 
coefficients  as  read  in.  CRDTAB  also  computes  the  inverse  trans- 
formation coefficients  from  the  input  data,  and  places  them  in 
GCOEFF,  and  in  the  tabout.'  See  figures  3-18  and  3-19  for  the 
input  card  formats  and  line  printer  tabout.  If  the  coefficients 
on  disk  are  to  be  used,  COEFCK  calls  DSKIN  to  read  the  data  from 
disk  and  COFDSP  to  output  the  coefficients  on  the  VT05  display. 
Figure  3-20  is  a sample  coefficient  VT05  display.  The  operator 
can  manually  change  any  of  the  displayed  coefficients  via  the 
VT05 . The  coefficient  data,  as  displayed,  is  set  up  in  the 
GCOEFF  common  and  then  written  back  to  the  REGCOF  disk  file,  via 
DSKOUT ; a tabout  of  the  coefficients  is  also  supplied  (see  figure 
3-21).  After  the  mapping  coefficients  are  input  to  the  system 
by  either  of  the  above  methods,  RGDISP  exits  to  the  SEDS  resident 

routine. 
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Figure  3-13  Registration  Initialization  Display 
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Figure  3-14  DAYRG1  Processing  Display 
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Figure  3-15  DAYRG2  Processing  Display 
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Figure  3-16  NITRG1  Processing  Display 
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Figure  3-17  NITRG2  Processing  Display 
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Figure  3-18  Coefficient  Card  Input  Format 
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*****MAPPING  coefficients— card  inputs***** 


DATE:  2 8-MAY- 75 

TIME:  00:01:22  DAY 


NO.  OF  GROUND  CONTROL  POINTS  IDENTIFIED-  7 

COEFFICIENTS : 


Al= 

426.74648 

A.2- 

0.99334598 

A3= 

0 

Bl= 

1330,16394 

B2= 

0.026830001 

B3= 

0 

EBAR=  1475.57104  SBAR=  1167.00000 


Figure  3-19  Coefficient  Line  Printer  Tabout 
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REGISTRATION  COEFFICIENTS 


* AS  READ  IN  FROM  DISK  FILE  /R  UPDATED  VI*  THE  VT05  AFTER  PHASE 

ORBIT  NO. I 3318 
DAY  PASS 

KSO.  OF  GROUND  CONTROL  POINTS  IDENTIFIED*  U 


HAPPING  COEFFICIENTS! 


A i • 

-37.38383 

A2>  0,98413241 

*3*  0 4 186968808 

RAl* 

271.58185 

RA2*  1,00017095 

R*3«-0, 168715328 

81* 

1388.08732 

B2*-0,o930S210a 

B3*  0,98981738 

rb*« 

■1376.83606 

H82*  0,094026441 

rB3*  0,99442655 

E8AR* 

1997.50000  SB  AH* 

1474,41663 

Xb  AH* 

-37,38363 

YBAH*  1366,06752 

Figure  3-21  Tabout  of  Disk-Stored  Coefficients 
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If  the  GCP  screening  option  is  selected,  RGDISP  maps  in  the  GCPID 
load  module  via  a SEG  call.  GCPID  first  outputs  the  initial  GCP 
display  to  the  VT05  (figure  3-22)  on  which  the  operator  selects 
the  first  portion  of  the  input  image  to  screen  by  entering  START 
SCAN,  START  PIXEL.  GCPID  interfaces  with  U9TRD  to  read  the  desig- 
nated data  off  the  EU  input  tape  and  with  DISPL  to  interface  with 
the  ICD  display  handler,  IDEH,  to  output  each  scan  to  the  inter- 
active color  display  screen.  See  paragraph  4.2.3  for  a descrip- 
tion of  U9TRD  and  paragraph  5.2.3  for  an  explanation  of  interfac- 
ing with  DISPL.  Call  packets  must  be  set  up  and  passed  with  the 
calls  to  U9TRD  and  DISPL,  describing  the  particular  function  to 
perform;  these  call  packets  and  formats  are  shown  in  figures  3-23 
and  3-24,  respectively. 

There  is  a control  panel  on  the  ICD  which  enables  the  operator  to 
control  the  screening  via  software,  to  color- enhance  the  data, 
and  to  magnify  the  displayed  image  to  facilitate  locating  key 
points.  The  control  panel  contains  a thumbwheel  switch  and  an 
INTERRUPT  button.  The  thumbwheel  switch  is  a two-digit  dial  which 
can  be  set  00  to  99.  When  the  INTERRUPT  button  is  depressed,  IDEH 
„ sets  up  a common  data  packet  containing  the  thumbwheel  dial  entry, 
the  X and  Y positions  of  the  screen  cursor,  and  a flag  set  to 
indicate  that  an  operator  interrupt  has  occurred.  GCPID  constantly 
monitors  the  packet  for  interrupts.  Following  are  the  dial  con- 
trols as  set  up. 

A.  00.  Signifies  a request  from  the  operator  to  halt  screen- 
ing temporarily  to  identify  GCP’s  in  the  displayed  image. 

B.  01-98.  Valid  ID  entries  for  GCP's. 

C.  99.  Signifies  a request  from  the  operator  to  continue 
with  screening  of  the  data  where  it  was  last  halted. 

To  identify  a point,  the  operator  first  halts  the  screening  pro- 
cess. He  positions  the  screen  cursor  directly  under  the  GCP  to 
be  identified,  sets  the  thumbwheel  dial  to  the  correct  ID  for 
that  point,  and  depresses  the  INTERRUPT  button.  The  common  packet 
is  set  up  as  described  above.  Upon  acknowledging  that  a GCP  has 
been  identified,  GCPID  calls  subroutine  PRCID.  PRCID  handles  all 
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Figure  3-22  Initial  GCP  VT05  Display 
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CALL  TO  U9TRD: 


JSR 

BR 

.WORD 

.WORD 

.WORD 


A: 


U9PAK: 

CHNPAK: 

+2 

STSCN: 

+4 

ENSCN: 

+6 

STPIX: 

+8 

SCNBUF: 

+10 

R5,@#U9TRD 

A 

U9PAK 

ADRTN 

U9STAT 


M M I)  II  11  10  3 ■ 7 • 3 4 3 * 10 


■ 

mm 

MB 

\M 

■ 

D 

BAS 

■ 

m 

mm 

asS 

IIJkliM 

CHANNEL  PACKET  ADDRESS 


START  SCAN  ON  TAPE  TO  READ 


STOP  (LAST)  SCAN  ON  TAPE  TO  READ 


START  PIXEL  WITHIN  SCAN  TO  TRANSFER 


TAPE  BUFFER  ADDRESS 

-*  1 1 i — *-  1 « 1 ■ i i « i 


*BIT  SET  INDICATES  NO  BYTE  REORDERING 
**BIT  SET  INDICATES  TO  WRITE  HEADER  RECORD 


STATUS  (BITS  6-7 ): 

6 - SET  IF  WRITE  IS  COMPLETE 

7 - SET  IF  TAPE  ERROR 


CHNPAK: 


+2 

+4 


II  14  IJ  II  (I  10  I I 7 6 3 4 3 t 10 

— I 1 1 1 1 1 1 1 1 I — 7 1 1 1 1 — 


NO.  OF  CHANNELS 


CHANNEL  N: 


CHANNEL  N2  (N^Ng) 


CHANNEL  N10 

-*■ i t » — i — i . .i.  i — » j *-  i i i i 


ADRTN: 


13  14  I)  II  11  10  3 • 7 4 3 4 3 < 10 

— I r'T'T'l 1 1 I 1 ! — I 1 1 1 — 1 — 

ADDRESS  OF  INPUT  DATA  (WITHIN  SCNBUF) 


Figure  3-23  U9TRD  Calling  Sequence 
and  Packet  Format 
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CALL  TO  DISPL: 


JSR 

R5,@#DISPL 

BR 

A 

.WORD 

COMBLK  ; 

INPUT  COMMAND 

.WORD 

ADRIN  ; 

DATA  ADDRESS 

.WORD 

DATRTN  ; 

MANUAL  INTERRUPT  PK. 

COMBLK: 


ADRTN : 


DATRTN : . 


*SET  IF  DISPLAY  TIMEOUT 
**SET  IF  BYPASS  INTERRUPT  COMPLETE 
***SET  IF  PRODUCT  IMAGE 

tSET  IF  FIRST  TIME  THRU 
ttSET  IF  RESTART 
tttSET  IF  INTERRUPT 

DATA  TYPE  (BITS  0-1); 


ii 

14  IS 

it 

ii 

10  • • 

7 

• 

1 4 1 t 

1 0 

0 

SI 

** 

Jj 

msa 

mm 

t 

tt 

1 1 1 T"™ 

COMPRESS 
FACTOR  41 

m 

3 

INPUT  DATA  ADDRESS 
(AS  SET  UP  BY  U9TRD) 


THUMBWHEEL  NO. 
IN  BCD. (00-99) 


X-POSITION 


Y-POSITION 


00  = DAY 
01.=  NIGHT 
10  = ANNOTATION 


->  ^pt^odUCIBILITY  OF  THE! 


Figure  3-24  DISPL  Calling  Sequence 
and  Packet  Format 
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identified  GCP's  and  any  ’’delete"  requests  for  the  previously 
entered  points.  PRCID  calls  a FORTRAN  subroutine,  CNVTES,  to  com- 
pute the  corresponding  E,S  in  the  input  image  from  the  XPOS,  YPOS 
coordinates  in  the  displayed  image  portion.  CNVTES  moves  the  com- 
puted E,S  into  the  EP  and  SP  arrays  of  the  GCPTAB  common  residing 
in  the  GCPBUF  data  module.  GCPBUF  is  a data  module  mapped  in  via 
SEG  to  transfer  and  receive  GCP  data  between  load  modules  during 
the  GCP  phase.  PRCID  then  maps  in  the  GCPEXC  load  module  via  SEG. 

GCPEXC  is  called  for  each  GCP  identified,  to  perform  the  functions 
of  fitting  the  operator- identified  GCP  to  the  corresponding  point 
(X , Y)  in  the  reference  grid.  Mapping  coefficients  are  computed 
using  a relationship  of  the  identified  GCP  coordinates  to  the  ref- 
erence grid  coordinates  for  all  identified  points.  In  the  case  of 
night  data,  the  coordinates  are  rotated  to  put  them  in  the  day 
pass  coordinate  system  prior  to  determining  the  coefficients. 
GCPEXC  also  computes  delta  errors  for  each  GCP  and  combined  errors 
for  E and  S.  All  mentioned  data  is  stored  in  the  GCPTAB  and 
GCOEFF  commons  for  use  by  PRCID  in  updating  the  GCP  display,  .and 
later  by  the  REG  CPC.  The  exact  flow  and  computations  performed 
by  GCPEXC  will  be  disucssed  in  more  detail  later  in  this  para- 
graph. 

GCPEXC  returns  control  to  PRCID  via  a return  SEG  call.  PRCID 
takes  the  data  from  GCPTAB  and  sets  it  up  to  be  output  to  the 
GCP  VTO 5 display.  PRCID  calls  a FORTRAN  subroutine,  NNCODE , to 
do  necessary  conversions  of  data  for  display  purposes.  The  dis- 
play is  refreshed  with  the  new  data  from  GCPEXC  (see  figure  3-25)  . 
The  operator  can  tell  from  the  data  displayed  how  accurate  the 
fit  was,  and  whether  he  identified  a point  significantly  off- 
course,  and  he  cun  get.  an  idea  of  when  enough  points  have  been 
identified  to  get  a good  registration  of  the  image. 

3,2.1. 1.3  GCP  Display.  Sigma  E and  Sigma  S represent  the  average 
error  deltas  of  E and  S of  those  GCP's  identified.  They  will 
increase  drastically  when  a point  has  been  incorrectly  located. 
There  are  six  mapping  coefficients  displayed  --  Ai , A2 , A3,  B]_, 

B2,  and  B3.  Of  the  six,  the  most  significant  one  to  watch  is  B2. 
Enough  GCP's  should  be  located  to  make  B2  fairly  constant,  and  in 
particular,  enough  GCP's  should  be  located  so  that  B2  does  not 
change  sign  when  a new  GCP  is  entered.  As  more  GCP's  are  entered, 
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Figure  3-25  Refreshed  GPC  VT05  Display 
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each  of  the  coefficients  A2 , A3,  B2*  and  B3  should  tend  to  stabi- 
lize --  ki  and  B3  to  numbers  near  1,  and  A3  and  B2  to  numbers 
near  0.  Ax  and  Bx  are  parts  of  the  translation,  and  cannot  be 
expected  to  stablize. 

A is  a scale  factor  in  the  PIXEL  direction,  and  should  be  expected 
to  be  close  to  1.  Numbers  below  1 represent  a compression  in  the 
PIXEL  direction;  numbers  larger  than  1 represent  a stretch.  For 
example,  A2  * 0.95  is  about  a 5 percent  compression  of  each  scan 
line  in  the  registered  image.  A2  = 1.05  is  about  a 5 percent 
stretch  of  each  scan  line  in  the  registered  image. 

A3  is  a vertical  skew.  If  it  is  positive,  the  registered  image 
is  skewed  to  the  right  (clockwise),  and  if  it  is  negative,  the 
registered  image  is  skewed  to  the  left  (counter-clockwise) . . 

B2  is  a rotation  from  the  horizontal.  This  is  the  buffer -critical 
value.  A value  of  ±0.017  is  a reasonable  maximum.  If  B2  is  posi- 
tive, horizontal  lines  in  the  registered  image  are  rotated  counter- 
clockwise; if  it  is  negative*  they  are  rotated  clockwise. 

B3  is  a scale  factor  in  the  downtrack  direction,  which  should  be 
expected  to  be  close  to  1.  As  in  the  case  of  A2,  it  is  unreason- 
able to  have  B3  outside  the  limits  0.95  to  1.05,  Numbers  below 
1 represent  a compression  in  the  downtrack  direction;  numbers 
larger  than  1 represent  a stretch.  For  example,  B3  = 0.95  will 
result  in  about  5 percent  of  the  scan  lines  being  deleted  in  the 
registered  image.  B3  = 1.05  will  result  in  about  5 percent  of 
the  scan  lines  being  repeated  in  the  registered  image.  B3  = 0.5 
will  result  in  a registered  image  about  half  as  long  as  the  un- 
registered image. 

The  way  the  program  is  currently  working,  if  a 0 or  1 ground  con- 
trol point  is  used,  Ax  and  Bx  are  the  only  calculated  values.  A2 
is  automatically  set  to  1,  A.3  to  0,  B2  to  0,  and  B3  to  1,  so  that 
the  user  gets  no  rotation,  skew,  or  scale  change. 

If  two  ground  control  points  are  used,  A3  and  B2  are  both  set  to 
0 so  that  the  user  gets  no  .rotation  and  skew.  However,  a scale 
change  in  both  the  PIXEL  and  scan  directions  is  calculated. 
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The  same  situation  holds  foi  three  ground  control  points.  If 
three  ground  control  points  are  used,  all  of  the  coefficients  are 
calculated,  but  if  the  ground  control  points  are  close  together, 
the  calculated  coefficients  cannot  be  expected  to  be  accurate. 

The  Delta  E and  Delta  S are  displayed  as  an  aid  to  detecting  when 
a ground  control  point  has  been  identified  incorrectly.  If  three 
or  fewer  ground  control  points  are  entered,  the  Delta  E and  Delta 
S are  comparisons  of  the  entered  locations  with  ephemeris  data. 
For  four  or  more  ground  control  points,  it  is  a comparison  of  the 
entered  location  with  the  calculated  locations  based  on  the  cal- 
culated coefficients.  Thus,  in  no  case  do  the  Delta  E and  Delta 
S represent  an  absolute  error  or  deviation  from  a known  location. 

When  an  adequate  number  of  GCP's  have  been  identified,  the  GCP 
phase  is  terminated  by  the  operator.  GCPID  returns  control  to 
the  RGDISP  load  module.  RGDISP  calls  subroutine  GCPCHK  to  see 
if  the  operator  wishes  to  view  the  coefficients  calculated  and 
change  any  to  their  offline  predicted  values  for  this  particular 
orbit  pass.  If  so  the  coefficients  are  displayed  via  COFDSP  and 
the  operator  is  free  to  make  changes  via  the  VT05.  The  coeffi- 
cients are  then  moved  back  into  GCOEFF  common  for  use  by  the  REG 
CPC,  and  then  written  onto  the  REGCOF  disk  file.  RGDISP  then 
calls  two  FORTRAN  subroutines,  GCPSTT  and  TABGCP,  to  tabulate 
on  the  line  printer  all  statistical  data  accumulated  by  GCPEXC 
load  module  in  the  GCPTAB  common  date  module.  RGDISP  then  exits 
to  the  SEDS  resident  routine  to  proceed  to  the  next  phase  of 
registration. 

3. 2. 1.1. 4 GCP  Tabout  Description.  Figure  3-26  shows  an  example 
of  the  GCP  tabout,  which  is  described  below. 

The  first  page  of  the  printout  (figure  3-26,  1 of  2)  contains  the 
coordinates  of  the  four  corners  and  center  of  the  input  image, 
reflected  as  (E,S),  and  the  four  corners  and  center  of  the  ref- 
erence grid,  reflected  as  (X,Y),  as  defined  by  the  fit  performed 
on  the  input  image.  The  corresponding  latitude  and  longitudes 
are  also  given  for  each  (E,S)  point. 
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Figure  3-26  GCP  Tabout  and  Description  (1  of  2) 
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Figure  3-26  (2  of  2) 
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The  second  page  of  the  printout  (figure  3-26,  2 of  2)  contains 
the  following: 

A.  Mapping  Coefficients  (Forward  and  Inverse  Transformation) 

1.  is  a part  of  the  translation  of  the  image.  This 
value  is  not  expected  to  stablize. 

2.  A2  is  a scale  factor  in  the  PIXEL  (E)  direction,  which 
should  be  close  to  1 (0.95  - 1.05);  < 1 represents  a 
compression  in  the  PIXEL  direction,  and  > 1 represents 
a stretch  in  the  PIXEL  direction. 

3.  A3  is  the  vertical  skew  factor.  If  it  is  positive  (+) , 
the  registered  image  is  skewed  to  the  right;  if  it 
negative  (-) , the  registered  image  is  skewed  to  the 
left.  The  value  should  stabilize  to  near  0. 

4.  Bi  is  a part  of  the  translation  of  the  image. 

5.  B2  is  the  rotation  from  the  horizontal.  A value  of 
±0.017  is  a reasonable  maximum.  If  B2  is  positive  (+) , 
horizontal  lines  in  the  registered  image  are  rotated 
counter-clockwise;  if  it  is  negative  (-) , they  are 
rotated  clockwise. 

6.  B3  is  the  scale  factor  in  the  downtrack  direction. 

This  value  should  be  close  to  1 (0.95  - 1.05);  <1 
represents  a compression  in  the  downtrack  direction, 
and  >1  represents  a stretch  in  the  downtrack  direc- 
tion. For  example,  B3  = 0.95  will  result  in  about 

5 percent  of  the  scan  lines  being  deleted  in  the 
registered  image,  B3  - 0.05  will  result  in  about  5 
percent  of  the  scan  lines  being  repeated  in  the 
registered  image. 

7.  RA^,  RA2 * * • RB2,  RB3  are  the  corresponding  mapping 
coefficients  for  the  inverse  transformation. 
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Arctan  A3.  This  is  approximately  the  angle,  measured  in 
degrees’,"  of  vertical  skew.  A positive  angle  will  result 
in  a registered  image  skewed  clockwise;  a negative  angle 
will  result  in  a registered  image  skewed  counter-clockwise. 

Arctan  B?.  This  is  approximately  the  angle,  measured  in 
degrees,'  of  horizontal  rotation.  A positive  angle  will 
result  in.  a registered  image  rotated  counter-clockwise;  a 
negative  angle  will  result  in  a registered  image  rotated 
clockwise . 

DVALUE.  This  is  a measure  of  linear  independence^ of  the 
GCP ' s If  they  are  all  in  a line,  DVALUE  is  smaller 
than  if  they  are  dispersed. 

OFFSET.  This  is  a measure  of  the  distance  of  the  average 
of  the  ground  control  points  (EBAR,  SBAR)  from  the  center 
of  the  input  image. 

DEVIATION.  This  is  a measure  of  the  spread  of  the  ground 
control  points. 

EBAR.  This  is  the  average  PIXEL  element  (E)  in  the  input 
Image  of  the  GCP’s  identified.  This  will  be  mapped,  dur- 
ing the  registering  of  the  data,  onto  the  corresponding 
point  XBAR,  which  is  the  average  PIXEL  of  the  points  se- 
lected as  defined  in  the  reference  grid. 

SBAR.  This  is  the  average  scan  line  (S)  in  the  input  image 
oTThe  input  GCP  ’ s identified.  This  will  be  mapped,  during 
the  registering  of  the  data  onto  the  corresponding  point 
YBAR,  which  is  the  average  scan  of  the  points  selected  as 
defined  in  the  reference  grid. 

XBAR.  This  is  the  value  obtained  by  taking  the  average  of 
the_X  coordinates  in  the  reference  grid  corresponding  to 
the  GCP’s  identified  from  the  input  image. 

YBAR.  This  is  the  value  obtained  by  taking  the  average  of 
the  Y coordinates  in  the  reference  grid  corresponding  to 
the  GCP's  identified  from  the  input  image. 
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K.  GCP's.  The  remainder  of  the  printout's  second  page  reflects 
the  GCP's  identified,  giving  the  (E,S)  coordinate  of  the 
point  as  selected  from  the  input  image,  the  E and  S errors 
of  each  point  identified,  and  a combined  error.  Sigma  E 
Sigma  S are  the  averages  of  the  E errors  and  S errors, 
respectively,  of  the  GCP's  identified.  Sigma  combined  is 
the  average  of  the  sum  of  the  E and  S errors. 

3. 2.1. 1.5  GCPEXC  Functions.  The  following  narrative  is  a tech- 
nical description  of  the  functions  of  the  GCPEXC  load  module  in 
computing  mapping  coefficients  and  the  image  fit  of  each  GCP 
identified. 

GCPEXC  is  responsible  for  computing  mapping  coefficients  A^,  A2,  A3 
Bi,  B2,  and  B3  for  use  in  mapping  the  operator- identified  points 
(EP,  SP)  onto  the  corresponding  (X,Y)  coordinates  in  the  reference 
grid.  Also  computed  are  the  inverse  transformation  coefficients 
RAi,  RA2,  RA3,  RBi,  RB2,  and  RB3  for  use  in  mapping  the  (X,Y)  co- 
ordinates in  the  reference  grid  onto  the  (EP , SP)  of  the  GCP's 
identified.  GCPEXC  calculates  a computed  PIXEL  and  scan  value 
(E,S)  for  each  GCP.  Pre-image  (or  inverse)  points  (El,  SI)  are 
found  by  using  the  inverse  coefficients  on  the  (X,Y)  reference 
grid  coordinates.  By  comparing  the  pre- image  points  with  the 
computed  points,  a delta  error  is  obtained  for  each  identified 
point  in  the  input  image.  All  of  this  information  is  used  in 
the  GCP  display. 

GCPEXC  first  checks  to  see  if  it  is  working  with  night  data.  If 
so  the  operator- j (lout  i Ti  oil  point  in  the  input  image  (EP , SP)  is 
coarse  rotated  clockwise  25.8  degrees  to  put  it  in  the  day  pass 
coordinate  system,  for  purposes  of  the  computations  to  be  per- 
formed. This  is  accomplished  by  a call  to  a FORTRAN  subroutine, 
ROTATE,  which  performs  the  calculations  below. 

Assuming  this  is  night  pass  data,  let  Ec  denote  the  center  picture 
element  in  the  input  image  and  Sc  denote  the  center  scan  line. 

Let  (EP,  SP)  denote  a GCP  identified  in  the  input  image.  Let: 

E'  'i  = EP  - E 

c 

S'  'i  = SP  - S 

c 
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Then  reset: 

EP  = (E^/cos  25.8°)  + int  (E ' ’ 

SP  = S • cos  25.8°  + int  (E"i 
c 

Now  (EP,SP)  will  be  treated  the 
point . 


i cos  2 5 . 8 ° - S ' ’ i sin  25.8°+0.5) 
s in  25 . 8 ° +S  ' ' i cos  25.8  +0.5) 
same  as  a day  pass  ground  conti ol 


GCPEXC  then  calculates  an  average  E,S  for  the  GCP’s  located  for 
night  or  day  pass  and  an  ’’estimated"  E,S  for  each  GCP  in  the 
input  image.  Let: 


E = ~ 2 EPi 
N 


Then  let: 


Note  that: 


S = | l SPi 
N 


Ei  = EPi  - E 

Si  = SPi  - S i = 1 , • • , N 


E Ei  = 2 Si  = 0 


The  next  step  is  to  compute  the  mapping  coefficients. 


Let  E denote  a PIXEL  and  S denote  a scan  line  number  in  the  input 
image.  On  a day  pass,  assume  that  the  value  of  E increases  from 
left  to  right,  and  S increases  from  bottom  to  top.  Suppose  a 
point  in  the  reference  grid  is  denoted  by  (X,Y).  The  operator 
wants  to  map  from  the  input  image  into  the  reference  grid.  He 
lust  find  constants  Ax,  A2)  Aj.  Blt  B2 , and  B3  so  that  given  a 
point  (E , S)  in  the  input  image: 


X = Ax  + A2  E + A3  S 

Y = B + B2  E + B3  S 
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The  operator  also  wants  the  constants  RAj,  RA2 , RA3,  RBi,  RB2, 
and  RB3,  for  the  inverse  transformation,  so  that  given  (X,Y)  in 
the  reference  grid,  its  pre-image  (El,  SI)  is  given  by: 

El  - RA1  + E + RA2  • X + RA3  • Y 

SI  = RB1  + S + RB2  • X + RB3  • Y 

Essentially,  A1  and  Bi  are  translation,  A2  and  B3  are  scaling,  and 

A3  and  B2  are  rotation  parameters.  The  operator  can  expect  A2  and 

B3  to  be  near  1 and  A3  and  B2  near  0. 

A.  Case  With  More  Than  Three  GCP 1 s . Let  (E^,Si),  i = !,•••, 

N,  N > 3,  denote  N computed  GCP’s  in  the  input  image 
located  by  the  operator,  and  let  (Xi,Yi)  be  the  corres- 
ponding known  locations  in  the  reference  grid.  A ’’least 
- , squares  fit”  will  be  obtained  using  the  Penrose  inverse. 

The  detailed  derivations  of  the  formula  are  omitted  in 
this  document.  Coefficients  are  Pound  by  the  following 
formulas. 

A = ^i[(E  Si2)  (2  X i Ei)  - (E  EiSi)  (E  X i Si)] 

tjU 

A3  = i [ (S  Ei2)(E  X i Si)  r ( E EiSi)  (E  X i Ei)  ] 

Also : 

T -1  T -+  -*■ 

(M  M)  J M Y = B 

So  that: 

Bi  ■ I E Y 1 

B2  = i t (E  Si2) (E  Y i Ei)  - (E  EiSi>(E  Y i Si)] 

B3  = i [(E  Ei2) (E  Y i Si)  - (E  EiSi)  (E  Y i Ei)] 
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So,  solving  the  system: 


X = A1  + A2  E + A3  S 
Y ■ B1  + B2  E + ®3  S 


for  E and  S,  we  get: 


E = 


S = 


Now  let: 


RA1  = 


RA2  ’ 


ra3  - 


RB. 


rb2  - 


rb3  - 


A3 

BrAi 

B3 

A2 

VA3 

\ 

'A1 

B2_A2 

*1 

A2 

VA3 

B2 

A3 

?1'A1 

B3 

A2 

B3-A3 

B2 

B3 

A2 

B3-A3 

B2 

-A3 

A2 

B3'A3 

B 2 

ai 

VA2 

B1 

A2 

VA3 

B2 

-B2 

A2 

B3'A3 

B2 

A2 

A2 

B3'A3 

B2 

eepkoducibmty  OP  rat 

ORIGINAL  PAGE  IS  POG 
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So  that : 


E = RA1  + E + RA2  • X + RA3 • • Y 
S = RB1  + S + RB2  • X + RB3  *Y 

B.  Three  GCP's.  The  method  described  in  paragraph  A will  be 
used  to  find  the  mapping  coefficients  in  case  N is  at  least 
3.  If  N is  3 the  operator  will  get  an  exact,  not  a least 
squares,  solution. 

C.  Two  GCP's.  Suppose  N = 2.  Let  (EP^,  SP-^)  and  EP2,  SP2) 
be  the  GCP  in  the  input  image  corresponding  to  (X^,  YjJ, 
and  (X2,  Y2)  respectively,  in  the  reference  grid.  In  the 
equations : 


X - A1  + A2  E + A3  S 
Y ' B1  + B2  E + B3  S 

Set : 


Define: 

E = | (EP1+EP2) 

s - i (siysi-2) 

Ei  .=  EPi  - E 

Si  ■ SP.  - S 
1 

Where : 


i = 1,2 
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Solving : 


X1  = A1  + A2  E1 
X2  = A1  + A2  E2 


for  and  k^y  the  operator  gets: 


\ - 


a„  = 


X1  E2  ' X2  E1 
E1  - E2 

X1  - X2 


2 B ' - E2 


If  E1  ‘ E2  = O’  let  A2  = 1,0  and  Ai  as  Per 


N = 1. 


Similarly,  solving: 


Y1  ■ B1  + B3  h 
YZ  " B1  + B3  S2 


for  and  the  operator  gets: 

B = Y1  S2  Y2  S1 
S1  - S2 


If  S - S2  = 0,  let  B3  = 1.0  and  find  B1  as  N - 1 

Then,  for  each  (E,S)  in  the  input  image: 

X = Af  + A2  E + 0 * S 
Y = B + 0-E  + B3  S 
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For  the  inverse  transformation,  given  (X, 
grid: 


D.  One  GCP.  Suppose  N = 1.  Let  (EP^,SP^)  be 
GCP  and  let  (Xi,Yi)  be  its  reference  grid 


Let  A2  and  B3  both  = 1,  and  let  B2  and  A 
Then,  for  each  (EP,SP): 


X = A. 

+ A2 

EP  + 

A3 

SP 

Y = B 

+ B2 

EP  + 

B3 

SP 

This  reduces  simply  to: 

X = Ax  + EP 

Y = B1  + SP 
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the  identified 
location.  Let: 


both  = 0. 
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Having  calculated  the  mapping  and  inverse  transformation  coeffi- 
cients, CCPEXC  performs  the  last  step,  computing  the  delta  errors 
and  sigmas  for  each  GCP,  where  the  delta  error  for  PIXEL  E = pre- 
image of  E - operator-identified  point  E. 

First,  we  must  find  the  pre-image  of  each  X,Y  in  the  reference 
grid  of  all  identified  GCP's.  GCDEXC  calls  a FORTRAN  subroutine, 
GCPNTS , to  compute  the  pre-image  points  (El,  SI)  from  the  reference 
grid  coordinates. 


El  . = 

l 

RA1 

+ E 

+ RA2 

* X.  + 

l 

RA3  * Y. 

i 

SI  . = 
i 

RBI 

+ S 

+ RB2 

* X.  + 

i 

RB3  * Y. 

l 

Where : 

X , Y.  = reference  grid  points  of  the  GCP's 
i 1 

S,  E - means  of  the  operator  - identified  GCP's  (EP  , SP^) 


If  the  operator  is  working  with  night  data,  he  wants  the  delta 
errors  and  sigmas  that  are  to  be  displayed  to  be  reflected  in  the 
night  pass  coordinate  plane.  As  defined  previously,  the  night 
points  (EP,SP)  had  been  rotated  to  lie  in  the  day  pass  coordinated 
plane  since  all  computations  of  coefficients  and  fit  are  per- 
formed in  this  coordinate  plane.  So,  GCPEXC  calls  a FORTRAN  sub- 
routine, INVROT,  to  perform  inverse  rotation  on  the  night  rotated 
points  (EPi,SPi).  The  pre-image  points  (EIi,SIi)  calculated 
above,  are  also  inverse  rotated  by  INVROT.  This  results  in  the 
night  points  (to  be  used  in  calculating  the  deltas  and  sigmas) 
to  be  defined  back  in  the  night  coordinate  plane. 

Note  that  after  rotation,  the  new  center  PIXEL  element  and  center 
scan  line,  denoted  by  EcR  and  ScR  respectively,  will  be  Ec-cos 
23.4°  and  Sc* cos  23.4°. 


r?  VPRODtJ C1BIL1TY  OF  TMF 
luNAL  PAGE  IS  POOR 
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If  (EP,SP)  is  a point  in  the  rotated  image,  then  its  inverse 
rotated  point  in  the  input  image  is  given  by  the  following 
equations : 

EPi  = Ec  + (EPi-EcR)  cos  25.8°  + (SPi-ScR)  sin  25.8° 
SP.  = Sc  - (EP i“CcR)  sin  25.8°  + (SP^Sc11)  cos  25.8° 

Where : 

i = 1,  N 
Also  : 

El.  = Ec  + (EI.-E  R)  cos  25.8°  + (SI.-ScR) 
i l c 

SI.  * Sc  - (EI.-EcR)  sin  25.8°  + (SI.-S  R) 

i l 1 


sin  25.8° 
cos  25.8° 


Where : 

i = 1,  N 

Now  GCPEXC  computes  the  delta  errors  (EDELTA,  SDELTA)  for  each 
GCP  to  reflect  the  relationship  of  the  entered  point  (EP,SP)  in 
comparison  with  its  calculated  location  (El, SI)  as  defined  by  the 
pre-image  of  reference  grid  location  (X,Y) . 

HDELTA . = El.  - BP. 

l l i 

SDELTA.  = SI.  - SP 

ill 

ESIGMA  arid  SGIGMA  are  then  computed  to  reflect  to  average  delta 
errors  of  all  identified  GCP's. 

GCPEXC  has  now  completed  its  functions  and  returns  to  GCPID,  where 
these  calculations  will  be  picked  up  from  the  GCPTAB  common  and 
displayed  to  the  operator  on  the  GCP  VT05  display.  GCPEXC  will 
be  called  again  after  the  next  GCP  has  been  identified  via  the 

operator. 

3,2.1. 2 Flow  Charts.  See  the  following  99  pages. 
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3. 2.1.3  Interfaces . This  paragraph  describes  the  interfaces  be- 
tween the  SRE  CPC  and  the  other  CPC’s  in  the  SRE  Program,  the  in- 
put and  output  data,  and  the  interfaces  between  the  SRE  CPC  and 
its  subcomponents  or  routines. 

A.  Input  Data.  The  input  data  to  the  SRE  CPC  is  as  follows. 

1.  EU  Input  Tape  Header  Record.  The  job  processing  load 
modules  (DAYRG1,  etc.)  read  the  input  header  to  extract 
data  for  the  processing  display. 

2.  EU  Input  Tape.  This  tape  is  used  by  GCPID  (U9TRD)  in 
the  data  image  screening  during  the  GCP  phase.  See 
figure  3-27  and  table  3-1  for  the  format  of  the  EU 
tape  and  EU  data  channels. 

3.  Coefficient  Card  Inputs.  Input  to  the  SRE  CPC  if  GCP 
phase  is  by-passed.  See  figure  3-18  for  a format  of 
the  card  deck. 

4.  Disk-Saved  Coefficients.  The  REGCOF.TBL  disk  file, 
containing  coefficients  for  the  last  day  and  night 
registration  runs,  is  read  into  the  system  for  restarts. 
See  figure  3-28  for  the  format  of  the  coefficient  disk 

f ile . 

B.  Output  Data.  The  output  data  of  the  SRE  CPC  is  as  follows. 

1.  Mapping  Coefficients  and  GCP  Phase  Data.  The  coeffi- 
cients completed  during  the  GCP  screening  are  stored 
in  the  GCOEFF  common  in  the  resident  common  data  area 
to  be  used  by  REG  CPC  in  the  registration  of  the  data 
image.  See  paragraph  3.1.5  for  a description  of  the 
GCOEFF  common. 

2.  Processing  Flags.  Flags  are  set  up  by  DAYRG1,  DAYRG2, 
etc.  according  to  the  operator  entries  on  the  processing 
display  for  the  output  options  selected.  See  paragraph 
3.1.5  for  a description  of  the  PRFLGS  common,  used  by 
the  ROT  and  REG  CPC’s. 


) 
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Figure  3-27  SEDS  Processed  9-Track  CCT  Format 
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TABLE  3-1 

PROCESSED  TAPE  BLOCKS 


BLOCK  BYTE 

ANCILLARY  BLOCK  (COUNTER  = 1*) 
DESCRIPTION 

1-4 

5-6 

7-68 

69-70 

CURRENT  GMT  AT  START  OF  THIS  DATA  SET  (TENTHS  OF  MILLISECONDS) 

CHANNEL  STATUS  FOR  THIS  SCAN.  LSB  OF  BYTES  5-6  (0  = CHANNEL  IN 
SYNC,  1 = CHANNEL  NOT  IN  SYNC),  ONE  BYTE  PER  CHANNEL 

CHANNELS  3-64  NOT  APPLICABLE.  LSB  OF  EACH  BYTE  = 1 

SCAN  LINE  NO.;  ARBITRARY  BUT  SEQUENTIAL  FOR  EACH  SCAN  LINE  OF 
THIS  DATA  RUN 

VIDEO  BLOCK  (COUNTER  = 2*) 

BLOCK  BYTE 

DESCRIPTION 

1-2500 

CHANNEL  OF  DATA,  UP  TO  2500  VIDEO  ELEMENTS: 

(OR  LESS) 

• NIGHT  TAPE  VIDEO  BLOCK  = 2500  SCANS  (1-1800  ELEMENTS) 

• DAY  TAPE  VIDEO  BLOCK  = 2200  SCANS  (1-2500  ELEMENTS) 

♦COUNTER  IS  IN  FIRST  TWO  BYTES  OF  PHYSICAL  RECORDS 

NOTE:  BYTES  OF  ZERO  FILL  ARE  REQUIRED  TO  COMPLETE  PHYSICAL  RECORD  LENGTH 

SPECIFIED  IN  HEADER  RECORD 
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Figure  3-28  REGCOF  Disk  File 
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3.  TAPEID  Common.  This  common,  residing  in  the  resident 
common  data  area,  contains  the  output  tape  ID’s  for  the 
coarse  rotated  tape,  registration  IR,  and  isothermal 
tapes,  as  input  on  the  processing  display  via  the  opera 
tor.  See  paragraph  3.1.5  for  a description  of  the 
TAPEID  common,  used  by  the  REG  and  ROT  CPC’s. 

C.  Calling  Sequence.  The  SRE  CPC  is  called  from  the  SEDS  resi 
dent  module  and  control  is  always  given  to  the  RGDISP  load 
module.  There  are  no  direct  calls  made  from  SRE  to  the 
other  two  CPC’s.  Each  CPC  has  a specialized  phase  of 
processing  to  accomplish  for  the  overall  registration  proc- 
ess. The  only  communication  or  interfacing  of  CPC's  is  . 
via  data  commons  in  the  resident  module  or  data  SEG  modules 

3. 2.1.4  Data  Organization.  As  discussed  previously,  data  modules 
of  4K  size  are  mapped  in  with  load  modules  via  SEG.  These  data 
modules  can  be  accessed  by  another  CPC,  and  it,  too,  can  have 
these  data  modules  mapped  into  core  at  140000  or  24-28K  in  the 
virtual  map.  Each  CPC  also  has  data,  tables,  and  buffers  unique 
to  its  own  modules  which  cannot  be  referenced  by  the  other  CPC's. 

3. 2. 1.4.1  Data  Modules 

A.  GCPBUF . This  is  a 4K  segment  block  data  module  which  is 
associated  with  the  GCPID  and  GCPEXC  load  modules  of  the 
SRE  CPC.  See  table  3-2  for  a format  of  the  GCPBUF  data 
module.  GCPBUF  is  used  only  for  GCP  phase  processing  to 
collect  statistics  and  GCP  ID's  located  via  the  operator. 
This  data  module  allows  a transfer  of  this  data  between 
GCPID  and  GCPEXC,  since  they  reside  in  separate  32K  verti- 
cal core.  GCPBUF  contains  three  common  blocks  --  GCPTAB, 
EPHEMR,  and  REFGRD.  Two  are  discussed  below. 

1.  GCPTAB . This  block  contains  the  data  accumulated  from 
identifying  GCP's,  such  as  the  ID's  selected,  the  delta 
errors,  signals,  computed  (E,S)'s,  etc. 

2.  REFGRD . This  block  contains  the  preassigned  X and  Y 
coordinates  of  the  GCP's  in  the  reference  grid.  It 

is  initialized  by  GRDINT  prior  to  performing  any  calcu- 
lations in  GCPEXC. 
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TABLE  3-2 

GCPBUF  BLOCK  DATA  MODULE 


X?TS^5),  YPTS(5),  RLAJ(5),  RLONG(5)  AT AN A3,  ATANB2 


IORBIT  - ORBIT  NO. 

N - NO.  OF  GCP'S  IDENTIFIED 

ID  - GCP  ID'S  IDENTIFIED  (1-98) 

IE,  E - ARRAY  OF  COMPUTED  PIXEL  VALUES  FOR  EACH  GCP  (REAL  & INTEGER) 

IS,  S - ARRAY  OF  COMPUTED  SCAN  VALUES  FOR  EACH  GCP  (REAL  .&  INTEGER) 

IED,  EP» ISP,  SP  - IDENTIFIED  COORDINATES  OF  GCP'S  (VIA  OPERATOR) 

IEDELT,  EDELTA  - DELTA  E (AE)  FOR  EACH  GCP  (REAL  & INTEGER) 

ISDELT,  SDELTA  - DELTA  S (AS)  FOR  EACH  GCP  (REAL  & INTEGER) 

ESIGMA,  SSIGMA  - AVERAGE  ERROR  DELTAS  OF  THE  PIXELS  (E)  AND  SCANS  (S)  OF 
THOSE  GCP'S  IDENTIFIED 


DVALUE  - LINEAR  INDEPENDENCE  OF  GCP'S  IDENTIFIED 

OFFSET  - MEASURE  OF  DISTANCE  OF  THE  MEAN  GCP  (EBAR,  SBAR)  FROM  THE  CENTER  OF 
THE  INPUT  IMAGE 


m ct  tct  ct  PRFTMAGE  COORDINATES  OF  EACH  GCP  IDENTIFIED,  COMPUTED  BY 
IE1.  El,  ISI.  SI  - S^^NVERSE  MAP  COEFFICIENT  ON  THE  (X.V)  REFERENCE  POINTS 


DVIATN  - MEASURE  OF  THE  SPREAD  OF  THE  GCP's  IDENTIFIED 

ERRCMB  - ARRAY  OF  COMBINED  ERRORS  (EDELTA  + SDELTA)  OF  GCP's  IDENTIFIED 

SIGCMD  - AVERAGE  OF  SUM  OF  E ERRORS  + S ERRORS  COMBINED  (ERRCMB) 

Trpp  Fpp  ispp  SPP  - EPHEMERIS-  GENERATED  GCP  COORDINATES  COMPUTED  FROM 
ltK  . ’ REFERENCE  GRID  COORDINATES 


IXPTS , XPTS , IYPTS , YPTS 


- THE  COMPUTED  REFERENCE  GRID  COORDINATES 
CORNERS  + CENTER  OF  THE  INPUT  IMAGE 


OF  THE  FOUR 


RLAT,  RLONG  - LATITUDE  + LONGITUDE  OF  THE  FIVE  POINTS 
ATANA3  - ANGLE,  MEASURED  IN  DEGREES,  OF  VERTICAL  SKEW 
ATANB2  - ANGLE,  MEASURED  IN  DEGREES,  OF  HORIZONTAL  ROTATION 
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REFGRD  COMMON:  (XP(98),  YP(98) 

XP  - ARRAi  OF  X( PIXEL)  COORDINATES  OF  THE  PREASSIGNED  GCP's  IN  THE  REFERENCE 
GRID 

YP  - ARRAY  OF  Y (SCAN)  COORDINATE  VALUES  OF  THE  PREASSIGNED  GCP's  IN  THE  REFER. 
ENCE  GRID 

EPHEMR  COMMON:  TF,  TEQ,  RLMBER,  PHIPRM,  RLMBDA,  IVE,  I YE,  I EE,  ISE,  A,  B 

COMMON  CONTAINS  EDPHEMERIS  DATA  READ  FROM  THE  EPHEMERIS  DISK  FILE  BY  ORBIT; 
LONGITUDE  AND  LATITUDE  CALCULATIONS  DONE  BY  PHMGCP,  AND  REFERENCE  GRID  COORDI- 
NATE CALCULATIONS 
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B*  1 NBU  1'1; . This  module  is  a 4K  segment  block  data  module  as- 
sociated with  the  processing  load  modules  DAY RG 1 , NITRG1 , 
etc.  It  is  used  to  read  the  EU  input  tape  header  record 
into . 

3.2. 1.4,2  Data  Tables  and I terns . The  following  data  is  used  only 

in  the  SRE  CPC.  Some  is  used  as  storage  locations,  some  as  in- 
ternally defined  symbols,  and  some  as  data  commons  used  in  trans- 
ferring data  between  assembly  and  FORTRAN  routines. 

A.  Common/ C0EFTS/A1 INT  t A2INT,  A5INT,  BUNT,  B2INT , B3INT, 
SGEINT,  SGSINT . This  common  contains  the  mapping  coeffi- 
cients for  the  GCP  VTO 5 display  in  ASCII  form.  The  FORTRAN 
routine  NNCODE  converts  the  required  coefficients  contained 
in  the  GCOEFF  common  and  GCPTAB  common  to  ASCII  so  PRCID 
can  output  them  to  the  VTO 5 display.  Each  variable  con- 
sists of  eight  bytes  (four  words) . 

B.  U9PAK . This  is  a packet  passed  to  U9TRD  which  is  necessary 
for  reading  the  input  tape  for  the  GCP  screening  process. 


*Where  to  store  data  scan  read  in 
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C.  CHNPAK.  This  is  a table  listing  channels  to  be  read  in. 


D.  STSCN,  ENSCN,  STPIX.  These  are  entries  on  the  VT05,  input 
via  the  operator  in  selecting  the  start  scan,  end  scan  and 
start  PIXEL  for  the  image  screening  during  GCP  phase. 

E.  SCNBUF . This  is  a 1530^q  word  buffer  used  by  U9TRD  to 
store  a data  scan  record  read  in  from  the  input  tape  for 
the  GCP  screening. 

F.  COMBLK.  A packet  passed  to  DISPL  in  outputting  a scan  of 
data  to  the  ICD  screen. 


If  14  13  II  It  10  • a 7 6 S 4 3 Z 10 


— 1 — 1 — 1 — 1 — 1 — 1 — 1 — 

— 1 — 1 — 1 — 1 — 1 — 1 — 1 — 

0 

204 

1 1 1 1 1 I « 

i i — i — « — i — i — i — 

G.  DLTID . This  is  a two-word  location  in  which  to  store 
"delete  ID”  inputs  from  the  VT05 . PRCID  uses  the  input  in 
DLTID  to  process  GCP  deletion  requests  from  the  operator. 

H.  ACTPIX . GCPID  picks  up  the  start  tape  PIXEL  number  from 
Fhn  input  In  •fid  or  and  stores  it  in  this  one -word  location  to 
be  displayed  on  the  GCP  display. 


I . CRNSN . GCPID  keeps  a counter  of  the  current  scan  output  to 
ICD.  This  one-word  entry  is  output  and  updated  on  the  GCP 
display. 

J.  IDNUM.  The  current  GCP  ID  is  stored  here  for  transfer  from 
GCPID  to  PRCID  to  process  the  ID  located. 

K.  XPOS  and  YPOS.  These  are  the  X and  Y positions  of  a GCP 
returned  in  the  monitor  packet  by  IDEH,  and  stored  for 
transfer  to  the  FORTRAN  subroutine  CNVTES. 
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DELTE  and  DELTS.  These  2210  word  buffers  contain  thejelta 
E and  delta'sTTor  each  identified  point,  computed  by  GCPE  . 
PRCID  transfers  the  delta  E and  S entries  from  the  GCPEU 
data  module  common  to  L3LTE  and  DELTS  for  purposes  of  dis- 
playing  them  on  the  GCP  display. 

PI STM  This  GCP  coefficient  VT05  display  command  block 
contains  background  display  and  commands  < describing  each 
input/output  field  on  the  display,  and  where  the  entry  val 
are  to  bestored  or  picked  up  for  displaying.  This  command 
block  is  passed  in  the  call  to  VTLINK  to  output  the  display. 


RGCMD1 , RGCMD2 , RGCMD3 , and 
7 ' *—* ,r  ■»’  1 


RGCMD4 . These  are  the  four 
blocks  contained  in  the  load 


processing  display  command  . 

modules  DAYRG1 , DAYRG2,  NITRG1,  and  NITRG2,  respectively. 
They  contain  the  display  background  and  commands  describing 
each  input/output  field  on  the  display.  These  commands 
are  passed  in  the  calls  to  VTLINK  to  output  the  displays 

when  necessary. 


RGCHD  This  is  the  registration  initialization 
block  in  INTDSP  (RGDISP  load  module), 
the  display  background  and  commands  describing 
output  field  and  is  passed  to  VTLINK  to  output 


display 
It  contains 
each  input/ 
the  display 


EB2ASC . This  is 
containing  ASCII 
ters  A-Z  and  0-9 
Ill's  . 


a table  residing  in  the  CHEK  Routine, 
and  EBCDIC  representations  of  the  charac- 
used  in  converting  header  data  and  tape 


SINANG  (=  0.4352311)  and  COSANG  (_= 
values  assigned  in  the  subroutine 
inverses  for  the  night  data. 


0.9005188)  . These  are 
INVROT  to  compute  the 


rfPDIS  This  is  the  GCP  statistics  display  command  block 
KfiD.  It  contains  the  display  background  and  commands 
describing  the  input/output  fields.  It  rs  passed  to  VTLINK 
to  output  the  display. 
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S.  REGCOF.  This  is  the  registration  coefficient  disk  file 
containing  the  mapping  coefficients  for  the  previous  day 
and  night  registration  runs.  See  figure  3-28. 

3.2. 1.5  Limitations . The  major  limitations  of  the  SRE  CPC  con- 
cern the  GCP  phase.  Due  to  the  magnitude  of  input  data  to  be 
screened  for  operator  identification  of  points,  several  passes 
must  be  made.  This  results  in  reading  of  the  entire  input  tape 
several  times  to  extract  the  designated  scans.  With  a larger  disk, 
it  would  be  possible  to  set  up,  for  example,  four  display  image 
sections  with  one  tape  read  operation.  Upon  request,  a specified 
image  section  could  be  shipped  directly  to  the  ICD  screen  for 
operator  viewing.  This  would  result  in  a speed-up  of  data  screening 
and  do  away  with  numerous  tape  rewinds  and  read  operations. 

Another  limitation  of  the  SRE  CPC  is  the  time  in  which  GCP  loca- 
tion is  performed  in  the  sequence  of  processing  NOAA  data.  Be- 
cause the  GCP  phase  is  located  in  the  registration  processing  mod- 
ule, after  EU  conversion  of  the  data  has  been  completed,  there  is  a 
loss  of  resolution  in  the  data  the  operator  is  viewing.  If  the 
GCP  phase  was  located  in  the  SEU  Program  prior  to  the  EU  conver- 
sion, the  resolution  of  the  image  for  screening  would  be  better, 
and  key  points  would  be  more  readily  identifiable  by  the  operator. 

There  is  room  on  the  VT05  GCP  display  for  only  21  operator- 
identified  point  entries  with  ID,  DELTA  E,  and  DELTA  S entries 
for  each.  So,  if  over  21  points  are  selected  via  the  operator, 
not  all  can  be  displayed  on  the  VT05. 

3. 2. 1.6  Listings . See  Part  IV  of  this  document,  published  under 
separate  cover. 


3-169 


JSC-10019 
Part  II 


3.2.2  ROT  (CPC  No.  2).  ROT  is  the  night  coarse  rotation  CPC.  The 
word  "coarse"  refers  to  a fixed  25.8-degree  rotation  of  the  night 
pass  scan  lines  to  orient  them  to  conform  approximately  with  the 
orientation  of  the  day  pass  scan  lines;  following  coarse  rotation, 
the  scan  lines  undergo  a fine  rotation  in  the  REG  CPC  just  as  do 
those  from  the  day  pass.  The  reader  is  therefore  cautioned  not  to 
confuse  the  word  "coarse"  (as  opposed  to  "fine")  with  the  word 
"course . " 

ROT  consists  of  three  load  modules  --  NTROTN.LDA,  RTPHAS.LDA,  and 
REGHED.LDA  --  and  three  major  programs  --  NTROTN.EXC,  RTPHAS.EXC, 
and  REGHED,  written  in  FORTRAN.  (Some  assembly  language  subrou- 
tines are  used  for  the  byte  move  operations.) 

ROT  inputs  a night  EU  tape  (SEN)  and  outputs  a coarse-rotated  tape 
(CRT).  The  CRT  has  the  scan  lines  resectioned  at  an  angle  of  25.8 
degrees,  and  has  the  image  inverted.  ROT  also  selects  1800  PIXEL’S 
per  scan  from  the  EU  tape. 

A detailed  description  of  the  ROT  CPC  follows. 

3. 2. 2.1  Description.  The  night  pass  image  must  be  rotated  clock- 
wise through  an  angle  0 (currently  0 is  25.8°),  have  the  order  of 
the  scan  lines  reversed,  and  have  the  order  of  the  PIXEL'S  within 
each  scan  line  reversed. 

The  scan  lines  are  read  from  the  EU  tape  into  an  input  buffer. 

From  here,  the  data  is  compressed  4:1  in  each  direction  into  an 
intermediate  buffer.  The  number  of  scan  lines  is  also  reduced  by 
a factor  of  cos  0 (0  = 25.8°)  by  deleting  some  lines.  Of  those 
left,  four  lines  at  a time  are  compressed  16:1  by  averaging.  Groups 
of  four  PIXEL'S  in  a scan  line  are  added  together,  the  shortened 
line  put  into  the  intermediate  buffer,  and  the  next  three  shortened 
scan  lines  added  to  it.  Each  of  these  sums  is  then  divided  by  16, 
and  the  line  is  read  onto  disk.  When  the  entire  image  has  been 
compressed  and  read  onto  disk,  it  is  read  in  reverse  order  into 
the  rotation  buffer  (i.e.,  the  last  line  read  in  is  the  first  line 
read  out).  When  the  rotation  buffer  is  half  full,  the  first  re- 
sectioned line  is  taken  out,  and  thereafter  one  line  is  taken  out 
for  each  line  put  in.  After  all  the  data  is  input,  another  half 
buffer  of  lines  are  output. 
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The  data  is  prescaled  in  the  downtrack  direction  and  postscaled  in 
the  crosstrack  direction.  Each  resectioned  line  is  reversed  left 
to  right,  decompressed  1:4,  and  expanded  by  a factor  of  sec  9 as 
it  is  assembled  in  the  output  buffer.  Each  line  is  always  repeated 
exactly  four  times  when  written  from  the  output  buffer  onto  tape. 
The  scaling  in  S (downtrack)  direction  by  cos  9 is  done  by 
NTROTN.EXC. 

The  16:1  compression,  and  the  writing  of  the  compressed  scans  to 
disk,  is  done  by  the  assembly  language  routine  CMPRES  in  the 
NTROTN  load  module. 

Reading  the  compressed  lines  from  disk  in  reverse  order  is  done 
by  the  assembly  routine  READSK  in  the  RTPHAS  load  module.  The 
line  resectioning  (scan  line  rotation),  reversal  of  PIXEL  order, 
scaling  in  E (crosstrack)  direction  by  sec  9,  and  expansion  by  1:4 
in  each  of  E and  S directions,  is  also  done  in  the  RTPHAS  load 
module . 

The  calculations  for  selecting  the  '’best'1  1800  PIXEL'S  are  done 
in  REGHED.  REGHED  also  reads  the  header  of  the  SEN  tape  and  writes 
the  header  of  the  CRT  tape. 

3. 2. 2. 1.1  Scan  Line  Deletion  Procedure  (NTROTN.EXC).  After  each 
scan  line  is  read  from  tape  into  the  input  buffer,  a decision  must 
be  made  whether  or  not  to  use  the  line  in  the  16:1  compression 
step.  The  number  of  scan  lines  is  reduced  by  a factor  of  cos  9 by 
a deletion  procedure  which  employs  the  method  shown  in  figure  3-29 
for  deciding  whether  or  not  to  use  an  input  scan  line.  In  figure 
3-29,  I refers  to  the  number  of  scan  lines  read  off  the  input  tape 
(i.e.,  the  first  line  read  off  the  tape  is  I = 1,  the  second  line 
read  off  is  I = 2,  etc.) 

3. 2. 2.1.2  16:1  Compression  Procedure  (CMPRES).  Starting  with  the 
first  selected  scan  line  of  a group  of  four,  the  first  four  PIXEL'S 
are  added  and  the  sum  written  into  the  first  position  of  an  inter- 
mediate buffer;  the  second  four  are  added  and  the  sum  written  into 
the  second  position  of  the  intermediate  buffer,  and  this  is  con- 
tinued until  the  entire  line  has  been  processed  (the  1800  PIXEL'S 
currently  used  make  450  sums) . For  the  second  scan  line  of  the 
group  of  four  scan  lines,  first  four  PIXEL'S  are  added  and  this 
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sum  is  added  to  the  contents  of  the  first  position  in  the  inter- 
mediate buffer.  Similiarly,  the  third  and  fourth  lines  are  added. 
Then  a binary  1000  is  added  to  each  word  of  the  intermediate  buf- 
fer and  it  is  right  shifted  4 bits.  This  serves  to  round  and  di- 
vide by  16.  Now  the  compressed  line  is  written  on  disk  and  the 
next  four  selected  lines  are  compressed.  This  continues  until 
2248  lines  have  been  compressed  and  stored  on  disk.  The  2500  scans 
on  the  input  tape  reduce  to  2250  when  scaled  by  cos  25.8°.  The 
last  two  are  deleted,  since  2250  is  not  divisible  by  4. 

3. 2. 2. 1.3  Line  Resectioning  Procedure  (RTPHAS . EXC) . A variable 
called  IZ  defines  for  each  output  line  how  many  elements  of  com- 
pressed zero  fill  to  use  at  one  end  of  the  output  line,  and  a 
variable  called  IB  defines  how  many  elements  of  compressed  image 
data  to  use  from  the  buffer.  In  figure  3-30,  cases  1 and  2 will 
have  the  output  buffer  filled  from  right  to  left,  and  cases  3 and 
4 will  have  the  output  buffer  filled  from  left  to  right.  Output 
of  resectioned  lines  from  the  rotation  buffer  starts  after  ISTART 
lines  have  been  input.  ISTART  is  computed  as  follows: 

ISTART  = Int  ( - C ]|in  9+0.5^ 

For  an  input  line  of  1800  PIXEL’S  and  for  which  0 = 25.8°,  ISTART  = 
98.  In  figure  3-30,  we  stay  in  case  1 and  case  4 for  a number  of 
lines  computed  by: 

Int  (f^-e  -Sc  sin  ej  + 0.5] 

For  0 » 25. 8° , Ec  = 900  and  Sc  = 1250  , case  1 and  case  4 are  each 
55  lines  long.  In  figure  3-30,  we  stay  in  case  2 and  case  3 for 
a number  of  lines  computed  by: 

Int  f -z rr  ( Sc  -Ec  tan  9 + 0.5 

|_4  cos  0 ^ 

Case  2 and  case  3 are  each  226  lines  long. 
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X DENOTES  UNUSED  INPUT  DATA 
0 DENOTES  ZERO  FILL  IN  OUTPUT  DATA 

Ec  DENOTES  HALF  THE  LENGTH  OF  A SCAN  LINE  IN  THE  INPUT  TAPE  IMAGE  (900  PIXELS) 
Sc  DENOTES  HALF  THE  NUMBER  OF  SCAN  LINES  IN  THE  INPUT  TAPE  IMAGE  (1250  SCANS) 


Figure  3-30  Line  Resectioning  Procedure  (Cases  1-4) 
n 
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For  cases  1 and  2,  the  formula  for  IZ  is: 


IZ 


Int 


T sin  0 

( Sc  cos  0-4N  ) 

LO 

o 

+ 

l 4 

\ / 

J 

Where  N = the  number  of  resectioned  lines  that  have  already  been 
output . 

For  case  1,  the  formula  for  IB  is: 

IB  = Int[?  (nn+Ec)  + °-5] 

For  case  2,  the  formula  for  IB  is: 

IB  = (buffer  width)  - IZ 

Formulas  are  needed  only  for  cases  1 and  2,  because  the  formulas 
are  used  backward  for  cases  3 and  4.  Each  case  is  described  as 
follows. 


A.  Case  1.  In  the  example  below,  we  are  resectioning  the 

L 1 th  line,  and  for  line  L the  formulas  say  to  take  z ele- 
ments of  zero  fill  and  b elements  from  the  buffer.  The 
order  of  the  PIXEL'S  must  be  reversed,  so  the  data  is  taken 
from  the  buffer  in  the  proper  way  to  accomplish  this  during 
the  resectioning  step.  The  top  figure  below  is  the  ro- 
tation buffer;  the  bottom  figure  is  the  output  buffer. 
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B.  Case  2.  In  this  example,  the  L’th  line  is  a case  2 line, 
and  the  formulas  say  to  take  z elements  of  zero  fill  and 
b elements  from  the  buffer. 


C . Transition  Between  Case  2 and  Case  5.  In  cases  1 and  2, 
data  is  always  taken  from  the  buffer  beginning  at  the  left 
edge  of  the  buffer;  in  cases  3 and  4,  it  is  always  taken 
beginning  at  the  right  edge  of  the  buffer.  The  last  line 
of  case  2 should  use  every  buffer  line.  The  last  element 
of  this  last  line  of  case  2 will  be  taken  from  the  right 
edge  of  a buffer  line.  The  next  buffer  line  will  be  the 
one  from  which  the  first  element  of  the  first  line  of  case 
3 is  taken. 


LAST  LINE 
OF  CASE  2 


FIRST  LINE 
OF  CASE  3 
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D.  Case  3.  In  this  example,  the  L’th  line  is  a case  3 line. 

Let  H denote  case  1 + case  2 length  (i.e.,  281), 

(1  ^ L ^ 2H) . The  values  we  will  use  for  line  L will  be 
2H  - L + 1.  Assume  that  the  formulas  say  to  take  z elements 
of  zero  fill  and  b elements  from  the  buffer. 


E.  Case  4.  In  this  example,  the  L'th  line  is  a case  4 line. 
Let  H denote  the  case  1 + case  2 length  (1  < L < 2H) . The 
values  we  will  use  for  line  L will  be  2H  - L + 1.  Suppose 
the  formulas  say  to  take  z elements  of  zero  fill  and  b 
elements  from  the  buffer. 
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t;  7 7.1.4  Scaling  of  Resectioned  Line.  When  assembling  the  re- 
sectioned  line  in  the  output  buffer,  the  elements  m the  buffer 
lines  are  repeated  an  average  of  4/cos  6 times  This  serves  to 
decompress  the  line  1:4  and  scale  by  a factor  of  1/cos  9 A table 
called  ITABLE  is  made,  telling  how  many  times  each  element  is  re 
;:“ed  when  assembling  the  resectioned  line.  Another  table  called 
JTAB1.E  is  made,  telling  how  many  elements  to  take  from  eac  i u 
fer  line  Let  w denote  the  buffer  width  and  l denote  the  buffer 
length.  Let  R = w/t.  Then  we  will  be  taking  an  average  of  R ele- 
Hients  from  each  buffer  line. 


an  ancle  of  25.8°  and  input  scan  line  length  of 


1800  PIXEL’S 


Por  cill  dJigiL  j-  ^ “ * r . J D 

the  rotation  buffer  is  196  lines  long  and  450  elements  wide.  R 

is  approximately  2.3,  which  means  that  sometimes  two  and  sometimes 
three  elements  are  taken  from  each  scan  line.  In  genera  , i 
denotes  half  the  number  of  PIXEL’S  in  each  input  scan  line,  then 

int  [ (2Ec/4)  sin  0 + 0.5]. 


w 


= int  [(2  Ec/4)  + 0.5]  and  l = 


As  mentioned  previously,  JTABLE  is  a table  set  up  to  tell  how 
many  elements  to  take  out  of  each  of  the  l buffer 

bling  the  resectioned  line  m the  output  buffer.  ITABLE  is  a table 
set  up  to  tell  how  many  times  each  of  the  elements  is  t0  re" 
peated  in  assembling  the  resectioned  line  in  the  output  buffer. 

We  continue  to  output  one  half  buffer-full  of  resectioned  lines 
after  the  last  buffer  line  has  been  put  in  from  the  disk.  The 
last  line  put  out  is  the  line  which  equals  case  1 + case  2 + case 
3 + case  4 = 562. 


3 2 2.1.5  Editing  the  El)  Image  to  1800  PIXEL’S  per  Scan.  Because 
of  buffer  limitations  for  the  resectioning  at  the  25.8-degree 
angle,  the  coarse  rotation  can  be  done  only  on  scan  lines  of 
1800-PIXEL  length.  The  SEN  tape  has  scan  lines  1801  to  2501 
PIXEL’S  long,  and  these  must  be  edited  to  1800  PIXEL  s before 
scan  line  resectioning  in  the  RTPHAS  load  module. 


Registration 
image.  When 
editing  must 


coefficients  are  generated  to  register  the  entire  EU 
the  scan  lines  are  shortened  in  coarse  rotation  the 
be  taken  into  account  during  the  registration  phase. 
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To  build  the  header  of  the  CRT  tape,  NTROTN  does  a SEG  call  to 
REGHED.  The  load  module  REGHED  is  also  part  of  the  registration 
(REG)  CPC,  and  will  be  discussed  in  more  detail  in  paragraph 
3. 2. 3.1.  Discussion  in  this  paragraph  is  limited  to  those  func- 
tions of  REGHED  specifically  pertaining  to  coarse  rotation. 

REGHED  reads  IFSPIX  (the  start  PIXEL  number)  and  IENPIX  (the  end 
PIXEL  number)  from  the  SEN  tape  header,  and  then  calculates  the 
correct  header  information  to  write  on  the  header  of  the  CRT  tape. 
A discussion  of  these  calculations  follows. 

The  operator  picks  a point  in  the  reference  grid  that  he  wants  to 
be  on  the  left  edge  of  the  registered  night  pass  image.  (Assume 
that  the  scan  lines  in  the  reference  grid  are  numbered  from  1 at 
the  bottom  to  2200  at  the  top.)  Let  the  chosen  point  have  coordi- 
nates (X,Y) . The  operator  defines  the  values  of  X and  Y in  a 
DATA  statement  in  REGHED.  The  current  choice  of  (X,Y)  is 
(375,1200),  chosen  in  an  attempt  to  optimize  coverage  of  south 
Texas  . 

In  REGHED,  the  position  in  the  input  image  of  the  point  (X,Y)  is 
located  by  the  formula: 

EDGEPX  = RA1  + EBAR  + RA2  * X + RA3  * Y 
EDGESN  = RB2  + SBAR  +RB2*X+RB3*Y 

Assuming  that  the  entire  EU  image  will  be  coarse  rotated,  (EDGEPX, 
EDGESN)  would  be  the  point  in  the  coarse  rotated  image  which  would 
be  mapped  into  (X,Y)  at  registration. 

Now,  (EDGEPX,  EDGESN)  must  be  inverse -rotated  to  find  the  inverse 
rotated  EDGEPX.  In  REGHED,  the  same  name  (EDGEPX)  is  used  after 
the  inverse  rotation.  Let  CNTPX  be  half  the  width  of  the  EU 
image;  then: 

CNTPX  = FLOAT  (IPXLST-IPXONE+2)/2 

Let  CNTSN  be  half  the  length  of  the  EU  image  (i.e.,  1250).  Then: 

EDGEPX  = CNTPX  + (EDGEPX-CNTPX/cos  25.8°)  * cos  25.8° 

+ (EDGESN -CNTSN* cos  25.8°)  * sin  25.8° 

This  inverse -rotates  EDGEPX. 
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Now  EDGEPX  is  the  PIXEL  number  of  the  point  in  the  input  EU  image 
which  would  map  into  (X,Y).  This  assumes  the  start  PIXEL  number 
is  1 in  the  input  EU  image,  which  is  the  same  assumption  made  in 
the  GCP  location  phase  and  in  the  generation  of  the  registration 
coefficients.  Since  EDGEPX+1799  may  be  outside  the  input  image, 
the  start  PIXEL  must  be  recalculated  to  get  the  best  1800  PIXEL'S. 
Let  IRTPX  = min  (width  of  input  image,  EDGEPX+1799).  Then: 

IRTPX  = MIN  (IPXLST- IPXONE+1 , EDGEPX+1799) 

Then,  let  ILFTPX  = MAX  (1,  IRTPX- 1799).  Now  ILFTPX  marks  the  left 
edge  * of  the  1800-PIXEL-wide  portion  to  be  taken  from  the  EU  image 
for  actual  coarse  rotation.  REGHED  puts  the  value  of  ILFTPX  in 
COMMON/GCOEFF/  to  be  used  in  the  NTROTN  load  module. 

Now  REGHED  calculates  the  start  PIXEL  number  of  the  coarse  rotated 
tape,  to  be  written  in  the  header.  Consider  the  point  in  the  EU 
input  image  defined  by: 


E = ILFTPX 

S = 1250  + 900  * tan  25.8° 

The  point  (E,S)  should  appear  on  the  left  edge  of  the  registered 
coarse  rotated  image.  Thus,  to  find  the  start  PIXEL  number  of  the 
coarse  rotated  tape,  (E,S)  must  be  rotated.  So,  let. 

ER  = CNTPX/cos  25.8°  + (E-CNTPX)  * cos  25.8° 

- (S-CNTSN)  * sin  25.8° 

SR  = CNTSN  * cos  25.8°  + (E-CNTPX)  * sin  25.8° 

+ (S-CNTSN)  * cos  25.8° 

Note  that  in  the  REGHED  program  listing,  ER  and  SR  are  named  E and 
S.  ER  is  the  start  PIXEL  number  that  REGHED  writes  in  the  header 
of  the  coarse  rotated  tape.  This  is  IFSPIX  in  COMMON/1 PFRMT/ . 

The  center  of  the  actual  coarse  rotated  image  is  not  the  same  as 
the  center  would  be  if  the  entire  EU  input  image  were  coarse  ro- 
tated. The  number  of  scan  lines  (2500*cos  25.8°)  is  the  same  in 
each  case.  The  center  of  the  actual  coarse  rotated  image  is  on 
scan  line  SR  of  the  hypothetical  coarse  rotated  entire  EU  image. 
This  results  in  a displacement  of  scan  lines  (i.e.,  scan  line  1 


3-180 


JSC-10019 
Part  II 


of  the  actual  coarse  rotated  image  would  not  be  scan  line  1 of  the 
image  obtained  if  the  entire  EU  input  image  were  coarse  rotated. 
The  registration  formulas  assume  that  the  entire  EU  image  is 
coarse  rotated;  therefore,  an  adjustment  must  be  added  for  the 
scan  line  displacement.  This  adjustment  is  called  IDEL  in  REGHED. 
Let : 

IDEL  = SR  - (2500  * cos  25.8°)  /Z 

IDEL  is  written  by  REGHED  in  bytes  117-118  of  the  header.  It  will 
be  read  by  REGHEF  during  the  registration  phase,  when  the  REGHED 
load  module  is  called  from  the  SREG  module.  IDEL  is  in  COMMON/ 
TPFRMT/ . 

After  writing  the  coarse  rotated  tape  header,  REGHED  returns  to 
NTROTN,  which  uses  ILFTPX  to  calculate  the  actual  PIXEL  in  the 
input  tape  at  which  to  begin  taking  the  1800  PIXEL’S.  ILFTPX 
cannot  be  used  directly  because  it  was  calculated  assuming  that 
the  left- to-right  reversal  of  the  night  image  had  already  been 
done.  However,  at  the  beginning  of  the  night  coarse  rotation 
processing,  each  scan  line  is  still  reversed  left- to-right . Let: 

ISHIFT  = ( 1 PXLST - IPXONE)  - (ILFTPX+1799) 

The  subroutine  CMPRES  will  add  ISHIFT  to  the  address  of  the  first 
PIXEL  in  the  input  buffer  to  get  the  address  at  which  to  begin 
taking  the  1800  PIXEL’S. 

3. 2. 2. 2 Flow  Charts.  See  table  3-3  for  a definition  of  symbols 
used  in  the  flow  charts  on  the  following  39  pages. 
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TABLE  3-3 

DEFINITION  OF  SYMBOLS  FOR  ROT  FLOWS 

I CAS  {I)  - NUMBER  OF  LINES  TAKEN  FROM  ROTATION  BUFFER  FOR  EACH  OF  FOUR  CASES 

ISTRT  - 98  - START  OUTPUTTING  RESECTIONED  LINES  AFTER  ISTRT  LINES  HAVE  BEEN 
PUT  INTO  ROTATION  BUFFER 

IW  = 1800/4  = 450  - ROTATION  BUFFER  WIDTH  (WIDTH  OF  LINE) 

IBFLTH  * 2*ISTRT  = 196  - ROTATION  BUFFER  LENGTH  (NUMBER  OF  LINES) 

I P I XL  - LENGTH  OF  OUTPUT  LINE 

IS  - ROTATION  BUFFER  INPUT  SCAN  LINE  POINTER  (1  to  196) 

LP  - BUFFER  LINE  POINTER;  INCREMENTS  IN  CASES  1 AND  2,  DECREMENTS  IN  CASES  3 
AND  4 

MPIXLC  - COMPRESSED  PIXEL  COUNTER 

ITABLE(MPIXLC)  - NUMBER  OF  TIMES  TO  REPEAT  COMPRESSED  PIXEL  IN  BUILDING  OUT- 
PUT LINE 

IBUFPX  - ROTATION  BUFFER  PIXEL  POINTER 

JTABLE  (LP)  - NUMBER  OF  BUFFER  PIXELS  TO  TAKE  FROM  BUFFER  LINE  LP  TO  BUILD 
OUTPUT  LINE 

EC  - 1800/2  - 900 

SC  - 2500/2  = 1250 

IPIXLC  - OUTPUT  BUFFER  POINTER;  DECREMENTS  IN  CASES  1 AND  2,  INCREMENTS  IN 
CASES  3 AND  4 

IZ  - COMPRESSED  ZERO  FILL  PIXELS 

IB  - NUMBER  OF  ROTATION  BUFFER  PIXELS  NEEDED  TO  BUILD  OUTPUT  LINE 

JTABLC  - COUNTER  FOR  JTABLE(LP)  (i.e.,  COUNTS  BUFFER  PIXELS  USED  FROM  BUFFER 
LINE  LP  TO  BUILD  OUTPUT  LINE) 

IH  - HALF  THE  NUMBER  OF  OUTPUT  LINES  TAKEN  FROM  ROTATION  BOFFER,  [i.e.,  ICAS(l) 
+ ICAS (2)  = 281] 
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3. 2. 2. 3 Interfaces . Input  data  consists  of  one  9-track  HU  tape 
called  SEN.  Output  data  consists  of  one  9-track  night  coarse 
rotated  tape,  or  CRT.  See  figure  3-31. 

The  ROT  MMC  is  called  from  the  SEDS  Resident  Program.  It  has 
only  one  entry  point,  and  is  self-contained  in  that  it  does  not 
use  any  input  data  except  the  information  in  the  SEN  tape  header 
to  process  the  SEN  data,  and  it  does  not  output  any  information 
other  than  that  written  in  the  CRT  tape  header. 

3. 2. 2. 4 Data  Organization. 

3. 2. 2. 4.1  Data  Organization  During  NTROTN  Phase.  One  scan  line 
at  a time  is  read  from  the  EU  tape  by  READIN.  A line  is  first 
read  into  the  double  buffer  INBUFF,  and  then  moved  to  CHBUFF, 
where  it  is  located  when  READIN  returns  to  NTROTN. EXC.  In  NTROTN, 
the  number  of  scan  lines  is  reduced  by  a factor  of  cos  25.80, 

so  that  some  of  the  scan  lines  are  not  used.  If  a line  is  used, 
it  is  compressed  by  CMPRES  in  the  intermediate  buffer  INTBUF, 
and  when  four  input  lines  have  been  compressed  in  INTBUF,  the 
compressed  line  is  written  to  a disk  buffer  called  CMPNYT.DAT 
(see  paragraph  3. 2. 2.1).  CMPNYT.DAT  is  organized  into  32  4K 
blocks.  Each  of  the  first  31  4K  blocks  has  18  compressed  lines 
of  450  bytes  each  for  a total  of  558  compressed  lines.  When  the 
2500  input  lines  are  scaled  by  a factor  of  cos  25.8°,  2250  lines 
are  left,  of  which  only  the  first  2248  are  used  because  that  is 
the  largest  multiple  of  4 in  2250.  Then,  compressing  the  2248 
lines  by  4 leaves  562  compressed  lines.  Thus,  the  32nd  block 
contains  only  four  compressed  lines.  During  the  RTPHAS  phase, 
these  blocks  are  read  out  in  reverse  order. 

3. 2. 2. 4. 2 Data  Organization  During  RTPHAS  Phase.  The  assembly 
language  program  READSK  reads  the  blocks  of  18  scan  lines  (the 
last  has  only  four  lines)  from  the  disk  file  CMPNYT.DAT  in  reverse 
order,  (last  in,  first  out).  A block  is  read  into  the  buffer 
BLKLNT,  which  has  4050  words.  From  there,  the  scans  are  put  into 
the  buffer  CHBUFF,  one  at  a time  in  reverse  order.  One  scan  is 
put  into  CHBUFF  each  time  READSK  is  called  by  RTPHAS. EXC.  Then 
RTPHAS  calls  STORIT  to  store  the  line  in  the  rotation  buffer 
ROTBUF.  ROTBUF  is  196  lines  long  (see  paragraph  3. 2. 2.1)  and  is 
organized  into  11  4K  blocks.  Each  of  the  first  10  blocks  has 

18  scan  lines,  and  the  11th  block  has  16  lines  (see  figure  3-8). 
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Figure  3-31  SEDS  Night  Coarse  Rotated  Tape  (CRT)  Format 
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The  counter  IS  counts  from  1 to  196,  and  is  carried  into  STORIT 
to  tell  STORIT  which  scan  is  being  stored.  When  the  197th  line 
is  moved  to  the  rotation  buffer,  IS  is  reset  to  1,  and  the  197th 
line  overlays,  the  first  line  in  the  buffer.  STORIT  uses  two 
words,  M2  and  M3,  to  determine  from  IS  where  in  ROTBUF  to  store 
the  incoming  line.  M2  is  used  by  SEG  to  map  in  the  correct  4K 
data  block.  M2  = IS/18  if  18  divides  IS;  otherwise  M2  = JNT(1S/18) 
+1.  Then,  the  formula  M3  = MOD(IS,  18)  is  used  by  AMOV  to  find 
the  correct  one  of  the  18  positions  in  the  M2nd  data  block. 

After  98  lines  have  been  stored  in  the  rotation  buffer,  one  re- 
sectioned line  is  built  after  each  new  line  is  stored.  The 
output  line  is  built  in  the  buffer  OUTBUF . To  build  this  line, 
the  program  uses  the  following  pointers,  counters,  etc. 

• LP  - Buffer  line  pointer  which  increments  in  cases  1 and  2, 
and  decrements  in  cases  3 and  4. 

• MPIXLC  - Compressed  PIXEL  counter 

• ITABLE  (MPIXLC)  - Number  of  times  to  repeat  compressed 
PIXEL  in  building  the  output  line. 

• JTABLC  - Counter  for  JTABLE  (LP) ; it  counts  buffer  PIXEL’S 
used  from  buffer  line  LP  to  build  the  output  line. 

• J2  - Number  of  compressed  zero-fill  PIXEL'S. 

• IB  - Number  of  rotation  buffer  PIXEL’S  needed  to  build  this 
output  line. 

• IBUFPX  - Rotation  buffer  PIXEL  pointer 

• IPIXL  - Length  of  output  line 

• IPIXLC  - Output  buffer  pointer  which  decrements  in  cases  1 
and  2,  and  increments  in  cases  3 and  4. 

The  subroutine  MAPBUF  uses  LP  to  calculate  M2  in  a similar  man- 
ner to  that  in  which  STORIT  uses  IS  to  calculate  M2.  SEG  uses 
M2  to  map  in  thelcorrect  4K  data  block.  Then  M3  points  to  the 
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correct  scan  line  in  this  block  of  18  scan  lines.  M3  is  also 
calculated  in  MAPBUF  using  LP,  just  as  M3  was  found  in  STORIT 
using  IS.  The  parameters  M2  and  M3  are  in  common  in  ROTMOV, 
which  picks  up  one  'buffer  PIXEL  at  a time  and  writes  it  into 
the  output  buffer  as  often  as  ITABLE  (MPIXLC)  indicates.  See 
paragraph  3. 2. 2.1  and  the  flow  charts  following  paragraph  3.2.2. 
for  more  details  on  how  the  output  scans  are  built.  When  night 
coarse  notation  is  finished,  the  flag  IPASS  is  changed  from  1 
to  2 to  indicate  that  coarse  rotation  is  over. 

3.2. 2. 5 Limitations.  The  coarse  rotated  tape  will  not  be  regis 
tered  correctly  if  the  EU  tape  has  scan  lines  of  less  than  1800 
PIXEL’S  each.  The  coarse  rotation  program  requires  an  EU  tape 
with  exactly  2500  scan  lines,  and  with  1800  to  2500  PIXEL’S  per 
scan. 

3. 2. 2. 6 Listings.  See  Part  III  of  this  document,  published 
under  separate  cover . 
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3.2.3  REG  (CPC  No.  3).  The  REG  CPC  performs  the  image  registra- 
tion of  the  EU  converted  input  data,  mapping  NOAA  satellite  day 
pass  or  inverted  night  pass  data  onto  the  SEDS  reference  gaid 
of  Mexico  and  the  southwest  position  of  the  United  States.  The 
REG  CPC  is  the  last  phase  of  the  SRE  Program.  It  is  called  from 
the  SEDS  resident  immediately  after  initialization  and  the  GCP 
phase  if  a day  pass  is  being  processed,  and  after  the  night 
coarse  rotation  phase  if  a night  pass  is  being  processed.  It 
uses  the  data  calculated  by  the  GCP  phase  or  input  via  cards  and 
disk  to  register  the  input  data  image  tape.  It  interfaces  with 
NT RAN  to  write  the  registered  data  to  disk  and  tape.  REG  also  pro- 
vides isothermal  products  (ICD  screening  and  tape)  by  interfacing 
with  the  Product  Generator  Modules  discussed  in  paragraph  5.2.3. 
REG  consists  of  three  load  modules  --  REGHED.LDA,  ISOMOD.LDA,  and 
SREG . LDA- -which  are  written  primarily  in  PDP  11/45  FORTRAN  except 
for  the  ISOMOD  module  routines,  which  are  written  in  PDP  11/45 

assembly  language. 

3. 2. 3.1  Description.  As  stated  previously,  REG  consists  of  three 
load  modules,  each  being  defined  in  a 32K  virtual  core  map  and 
each  called  in  via  SEG  to  perform  its  varied  functions  where  nec- 
essary. This  paragraph  discusses  the  design  flow  and  functions 
of  REG,  including  the  role  of  each  load  module  in  performing  these 
functions.  A brief  description  of  the  three  load  modules  follows. 

A.  SREG.  This  is  the  main  executive  load  module  of  REG,  con- 
trolling the  processing  sequence  flow  and  responsible  for 
mapping  in  the  other  two  load  modules.  SREG  modules  perform 
the  actual  processing  of  the  input  data,  such  as  the  trans- 
lation, scaling  and  resectioning  required  to  register  the 
image.  SREG  is  responsible  for  the  output  of  the  registered 
data  to  tape  and  disk.  Its  routines  and  subroutines  are  as 
follows . 

X.  SREG.  This  is  the  main  routine  (FORTRAN) . 

2.  READIN.  The  input  tape  read  routine  (FORTRAN). 

3.  SCNFIL . A routine  to  write  out  zero-fill  scans 
(FORTRAN) . 
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4.  TRNSCL.  A routine  to  translate  and  scale  the  input 
data  (FORTRAN). 

5.  TSHIFT . This  routine  moves  the  translated  data  into 
the  rotation  buffer  (assembly) . 

6.  TODISK . This  routine  writes  the  registered  data  scan 
to  “disk  (FORTRAN) . 

7.  TOTAPE.  This  routine  writes  the  registered  IR  data 
scans  to  tape  for  optional  output  (FORTRAN) . 

8.  R TAT ON.  This  routine  generates  an  output  registered 
scan  by  rotating  the  translated  and  scaled  input  data 
(FORTRAN) . 

9.  CALCIT  and  EMI  SIT.  These  routines  perform  emissivity 
correction  to  the  4:1  compressed  registered  data  prior 
to  its  being  written  to  disk. 

10.  PXTBLE . This  routine  computes  the  number  of  PIXEL'S  to 
be  taken  from  each  line  of  the  rotation  buffer  in  the 
resectioning  (rotation)  of  the  data  (FORTRAN) . 

11.  MOVBTS . This  routine  moves  specified  bytes  from  one 
array  to  the  same  location  in  an  output  array 
(assembly) . 

B.  RHCil IHl) . This  load  module  is  responsible  for  decoding  the 
input  tape  header  and  for  building  the  output  header  for 
the  registered  data  output  to  disk  and  tape.  Called  by 
SREG  prior  to  any  data  processing,  REGHED  is  also  called 
by  NTROTN  to  build  the  output  header  for  the  coarse  rotated 
tape  in  the  ROT  CPC.  Its  routines  and  subroutines  are  as 
follows . 

1.  REGHED.  Tills  is  the  main  routine  (FORTRAN) 

2.  HD2DSK.  This  subroutine  writes  the  registered  data 
header  record  (SEDREG.HDR)  to  disk  (FORTRAN). 
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3.  BLDIlED.  Tills  routine  builds  the  output  header  for 
the  registration  disk  file  (SEDREG.HDR)  and  for  the 
coarse  rotated  tape. 

BSIVAP  and  AMQV.  These  are  utility  routines  to  perform 
byte- swapping  and  byte  moves. 

C.  ISOMD.  This  load  module  is  responsible  for  intei facing 

with~PDGEN  to  build  an  isothermal  output  product  tape  and/ 
or  provide  isothermal  screening  of  compressed  or  full-scale 
III  registered  data  to  the  interactive  color  display  C I CD) . 
It  is  called  by  SREG  if  isothermal  products  are  requested. 
Its  main  routine  is  ISOMOD,  written  in  assembly  language. 
Its  other  routines  --  OPNOT,  ANNOT , PDGEN , U9WRT , FCGEN, 
FCTBL,  and  DISPL  --  are  described  in  paragraph  5. 2. 3.1. 

They  are  all  part  of  the  product  generation  component  of 

SSP, 


3.2. 3.1.1  Program  Flow.  REG  is  called  up  from  the  SF.DS  lesidcnt 
module  by  making  a call  to  NEWMMC  to  map  in  the  REG  physical  mem- 
ory map  configuration  as  portrayed  in  figure  3-11.  Then  a SEC 
call  is  made  to  load  the  SREG  load  module  into  the  32K  virtual 
core  executable  area.  See  figure  3-10.  SREG  gains  program  con- 
trol and  calls  the  REGHED  load  module  first  to  process  and  build 

the  necessary  output  headers. 


REGHED  uses  NT RAN  to  read  the  header  off  the  input  tape  (EU  tape 
Cor  day , CRT  tape  for  night).  Input  tape  values  are  picked  up 
from  the  header  and  stored  in  the  TPFRMT  common  to  be  used  by  SRE 3 
later.  See  paragraph  3.1.5  for  a description  of  the  TPFRMT  com- 
mon. REGHED  transfers  the  registered  IR  tape  ID,  input  via  the 
operator  on  the  VT05  (COMMON  TAPEID) , to  the  output  header  buffer 
INDAT.  A call  is  made  to  BLD11ED  to  complete  the  output  headci 
in  the  INDAT  buffer.  If  the  IR  registered  tape  output  was  selected 
via  the  operator,  REGHED  writes  the  completed  header  buffer  INDAT 
to  the  output  tape  on  MT2  and  then  calls  the  subroutine  I1D2DSK  to 
output  the  header  to  the  SEDREG.HDR  disk  file  on  DK1.  REGHED 
exits  to  SREG  via  a SEG  call. 
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SREG  is  now  ready  to  begin  processing  the  input  data.  For  a day 
registration  run,  two  passes  are  made  through  SREG,  the  first  to 
register  the  IR  channel  data  and  the  second  to  register  the  VIS 
data.  Any  additional  output  products  (i.e.,  isothermal,  etc.) 
are  processed  during  the  IR  channel  pass.  For  a night  registra- 
tion run,  there  is  only  one  pass  through  SREG  to  register  the  IR 

channel . 

First  a preliminary  explanation  of  registration  is  given.  In 
the  registration  phase,  it  must  be  considered  that  the  reference 
grid  is  a rectangle  with  2200  scan  lines  of  2500  PIXEL'S  each,  and 
is  here  a right-handed  coordinate  system.  The  corners  are  defined 
in  COMMON/ CORN RS/  as  ICA  = 1,  ICB  = 1,  ICC  = 2500,  and  ICD  = 2200. 
If  X is  defined  as  the  PIXEL  number  and  Y as  the  scan  number  in  the 
reference  grid  (output  image  of  SRE) , the  following  schematic  is 
produced : 

(ICC, ICD) 


(ICC,  ICB) 


The  input  image  will  have  scan  lines  denoted  by  S (or  IS  for  the 
integer  part),  and  PIXEL'S  denoted  by  E (or  IE  for  the  integer 
part).  For  each  point  (X,Y)  in  the  reference  grid,  it  is  neces- 
sary to  place  in  the  output  image  the  correct  PIXEL  (E,Sj  m the 
input  image  according  to  the  formulas: 

E = RA1  +EBAR  * RA2  * X + RA3  * Y 


S RBI  + SBAR  + RB2  * X + RB3  * Y 

The  coefficients  RA1 , EBAR,  RA2 , etc.  were  calculated  in  the  SRE 
CPC,  and  are  available  in  COMMON/GCOEFF/ . 

Basically,  in  SREG,  data  moves  from  an  input  data  module  (INBUFF)  to 
an  internal  buffer  (CHBUFF) . READIN  reads  an  input  data  scan  from 
tape  (SEN  or  CRT)  into  the  double-buffered  INBUFF.  From  here,  the 
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scan  is 
recc ivin 
moved  in 
col lecte 
sect i one 
OUTBUF. 
every  £o 
tcred  sc 


moved  to  CIIBUFF  to  be  processed.  Meanwhile,  INBUFF  is 
g the  next  scan  to  process.  From  CHBUFF , the  data  is 
to  the  rotation  buffer  ROTBUF,  where  a number  of  scans  ait 
d to  be  resectioned.  From  the  rotation  buffer,  the  re- 
d scan  lines  are  built  one  at  a time  in  the  output  buffet 
As  the  last  step,  TODISK  takes  every  fourth  PIXEL  ot 
urth  scan  line  in  OUTBUF  and  builds  a compressed  regis- 
an  in  DSKBUF  for  output  to  the  disk  file. 


Processing  is  from  the  top  of  the  image  on  down  (i.e. , scan  Y 
22«0  is  the  first  scan  line  to  be  resectioned  from  the  rotation 

buffer  to  OUTBUF). 

Approximately,  translation  in  the  downtrack  (Yf)rH^^tlt°ns^r?Cfrom 
complied  by  choosing  which  input  scan  line  CHBUFF to  start  fro 
as  thp  first  line  into  the  rotation  buffer.  If  the  input  image 
starts  at  a point  higher  than  the  top  of  the 

nrovram  must  start  further  into  the  input  tape  to  get  the  first 
scan  for  the  rotation  buffer.  If  the  input  image  starts  at  a 
point  lower  than  the  top  of  the  reference  gi i , „ . 

lines  must  be  put  in  the  rotation  buffer  via  the  SCNFIL  routine. 
Scaling  in  the1  downtrack  (Y)  direction  is  accomplished  either 
by  repeating  some  input  lines  in  the  rotation  buffer  or  y 
leting  some  input  lines. 

Translation  in  the  crosstrack  (X)  direct  ion  and  also  Performance 
of  the  skew  correction  is  accomplished  by  choosing  . 

ill  ime  to  place  in  the  first  PIXEL  position  m the 

rotation  buffer.  This  PIXEL  is  recalculated  for  Qach  input  scan 
line,  thus  accomplishing  the  skew  correction.  Ihc  paling  in  tx 
pross track  direction  is  done  by  repeating  some  of  the  input  Unc  _ 
PIXEL'S  when  writing  a line  into  the  rotation  buffer,  or  by  delet 

ing  some  PIXEL'S. 

Rotation  in  the  crosstrack  direction  is  accomplished  by  putting 
as  many  input  scans  as  are  needed  into  the  rotation  bufier, 
then  resectioning  to  form  one  output  line,  as  shown  belo  . 


- n i ic  r CFJ 


| INPUT  LIN 
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There  are  two  cases  involving 

s uclhcalcul  at  ions  i depending  o~  he  sign  of  RB2.  Schematically, 


3. 2. 3. 1.2  Scan  Line  Calculations. 


an  output  line  in  the  rotation  buffer  is  as  shown  below: 


If  RB2  £ 0,  let: 


W = (ICA-X)  * RB2/RB3 


If  RB2  > 0,  let: 


w = (ICC-X)  * RB2/RB3 


In  SREG,  Y is  called  YSCAN,  and  S is  called  SD. 
of  the  input  tape  to  put  first  into  the  rotation 

YSCAN  = I CD,  and  let: 


To  find  the  scan 
buffer,  set 


SD  = RBI  + SBAR  + RB 2 * XBAR  + RB3  * YSCAN  + WTILDE  + 0.5 


All  the  rotation  and  scaling  will 
about  the  T PIXEL. 


be  done  in  the  X direction, 


Now,  SD  must  be  compared  with  the  first  line  on  the  input  tape. 
The  first  scan  on  the  input  tape  is  numbered  1 m the  ancillary. 
The  numbers  must  be  inverted  from  a top-to-bottom  system  to  a 
bottom-to-top  system.  Let  ISCAN  be  the  scan  number  m the  ancil 

lary . Then  let: 


ISNCOR  - 2201  - ISCAN  for  a day  pass 

ISNCOR  = 2249  - ISCAN  + IDEL  for  a night  pass 
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The  day  pass  input  tape  (SED)  has  2200  lines  and  the  night  pass 
input  tape  (CRT)  has  2248  lines.  For  a discussion  of  IDEL  see 
paragraph  3. 2. 2.1. 

Suppose  the  first  SD  and  first  ISNCOR  have  been  found.  If  SD  < 
ISNCOR,  the  input  tape  is  read  through  via  READIN  until  ISNCOR  = 
SI).  If  SD  > ISNCOR,  SREG.EXC  calls  SCNFIL  to  put  zero  fill  lines 
into  the  rotation  buffer.  Each  time  a zero  fill  line  is  written 
by  SCNFIL,  it  recalculates  SD.  Zero  lines  are  written  in  the 
rotation  buffer  until  SD  = ISNCOR.  SCNFIL  then  returns  to 
SREG.EXC  and  the  first  scan  line  is  read  in  from  the  input  tape 
by  READIN,  and  is  put  into  the  internal  buffer  CHBUFF. 

SI)  is  recalculated  according  to  the  formula: 

(new)  SD  = (old)  SD  - RB3 

Each  time  a line  is  written  into  the  internal  buffer,  SREG  cal- 
culates the  PIXEL  number  of  the  input  line  to  put  into  the  first 
PIXEL  position  of  the  rotation  buffer.  This  PIXEL  is  called  ED 
in  SREG.  Note  that  the  first  time  a line  was  written  to  the  ro- 
tation buffer,  YSCAN  was  set  to  ICD.  Each  time  a line  is  written, 
YSCAN  is  decremented  by  1.  ED  is  calculated  as  follows: 

I f RB2  £ 0, 

ED  = RA1  + EBAR  + RA2  * ICA  + RA3  * YSCAN  +0.5 
I f RB2  > 0, 

ED  = RA1  + EBAR  + RA2  * ICA  + RA3  * (YSCAN+2 500*RB2/RB3) 

+ 0.5 

SREG  now  calls  TRNSCL  to  perform  the  translation  and  scaling  of 
the  input  data  from  CHBUFF  into  the  rotation  buffer  ROTBUF. 

The  PIXEL'S  are  moved  by  TSHIFT,  which  is  called  from  TRNSCL.  In 
TSUI  FT,  each  time  a PIXEL  is  moved  to  the  rotation  buffer,  the 
PIXEL  number  of  the  next  PIXEL  to  move  is  recalculated  according 
to  the  formula: 

(new)  ED  = (old)  ED  + RA2  - RA3  * RB2/RB3 
This  formula  serves  to  properly  scale  in  the  X direction. 
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Th.6  number  o£  scan  lines  which  must  be  input  to  the  rotation  bu£ 
fer  in  order  to  take  one  resectional  line  out  is  called  NSETS  and 
was  calculated  previously  in  SREG . The  formula  is: 

NSETS  = 2500  * ABS  (RB2/RB3)  +1.5 

The  rotation  buffer  as  set  up  in  physical  core  has  room  for  54 
scan  lines.  If  NSETS  is  larger  than  54,  SREG  compresses  in  the 
downtrack  direction  by  deleting  some  scan  lines  on  input  to  the 
rotation  buffer  and  then  expands  on  output  by  repeating  some 

scan  lines. 

The  compression  factor,  CMPRS,  is  calculated  from  the  formula: 

CMPRS  = 53.  * RB3/  [2500. *ABS (RB2) ] 

The  expansion  factor,  EXPAND,  is  1/CMPRS. 

NSETS  is  reset  to  54,  and  lines  are  resectioned  from  the  rotation 
buffer  as  though  NSETS  had  always  been  54. 

The  logic  shown  in  figure  3-32  is  used  for  the  compression  on 
input  to  the  rotation  buffer.  Let  I COUNT  be  the  number  of  scan 
lines  read  off  the  input  tape.  Begin  with  ICOUNT  = 0 and 
N COUNT  =0. 

Once  NSETS  lines  are  put  in  the  rotation  buffer  by  TRNSCL , re- 
sectioning the  line  for  output  is  quite  straightforward.  An  equal 
number  of  PIXEL’S  from  each  buffer  line  must  be  taken  for  a total 
of  2500  PIXEL'S.  Thus,  an  average  of  RB3/RB2  PIXEL’S  must  be  taken 
from  each  rotation  buffer  line.  Since  this  is  not  an  integer, 
more  lines  than  this  are  cometimes  taken  and  less  than  this  are 
sometimes  taken.  Before  resectioning  any  lines,  SREG  calls 
PXTBLE  to  set  up  the  table  (TBLEPX)  telling  how  many  PIXEL'S  to 
take  from  each  line.  Refer  to  the  PXTBLE  flow  chart  for  the 
scheme  of  building  the  table. 

To  build  a resectioned  line  from  ROTBUF  into  the  output  buffer 
OUTBUF  RTATON  is  called  by  SREG.  The  most  recent  line  input  to 
the  buffer  is  the  first  line  from  which  PIXEL'S  are  moved  to  the 
output  buffer.  If  RB2  is  negative,  the  line  is  built  backward, 
starting  at  the  right  and  working  down  to  the  left.  If  RB2  is 
positive,  the  line  is  built  from  left  to  right,  with  PIXEL  1 out- 
put first  and  PIXEL  2500  output  last. 
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Figure  3-32  Compression  Logic  for  Input  to 
Rotation  Buffer 
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ROTBUF  is  set  up  into  a 4K  data  block  repeated  18  times  in  physi- 
cal core  to  equal  72K.  Each  4K  block  can  contain  up  to  three 
scan  lines  of  corrected  data  as  input  by  TRNSCL.  So,  for  the  18 
repeated  4K  blocks,  ROTBUF  can  hold  up  to  a maximum  of  54  scan 
lines  from  which  RTATON  performs  the  resectioning  to  build  one 
output  registered  scan.  The  data  is  resectioned  from  the  last 
scan  line  in  ROTBUF  upwards,  so  that  RTATON  calls  SEG  to  map  in 
the  last  of  the  4K  blocks  (Nl)  which  was  written  into.  RTATON 
picks  up  the  number  of  PIXEL’S  to  use  as  an  entry  in  TBLEPX  for  the 
particular  ‘Scan  line,  and  calls  MOVBTS  to  move  the  designated 
PIXEL'S  from  the  ROTBUF  scan  to  the  output  buffer  OUTBUF.  As  each 
4K  block  of  ROTBUF  is  required,  RTATON  calls  SEG  to  map  in  the 
Nl-1  4K  block,  relieves  the  TBLEPX  entry,  and  so  on  to  collect  the 
necessary  PIXEL'S  for  output.  This  continues  until  RTATON  has 
built  one  output  scan  line  from  all  the  data  scans  in  ROTBUF. 

RTATON  when  exits  to  SREG.  SREG  enters  the  expansion  logic  to 
determine  how  many  times  to  write  the  resultant  output  line  from 
OUTBUF  to  tape  and  disk.  The  logic  is  as.  follows  (see  figure  3-  j 


Begin  with  JCOUNT  = 0 and  NN  = 0.  Let  JCOUNT  count  the  number  of 
times  the  write  loop  is  entered.  When  the  write  loop  is  entered, 
there  is  an  output  line  in  OUTBUF,  which  will  be  written  to  tape 
as  often  as  necessary,  as  determined  by  the  logic  in  the  write 

loop. 

The  logic  for  downtrack  scaling,  and  the  logic  for  the  compression 
on  input  and  expansion  on  output  from  the  rotation  buffer  that  is 
in  SREG.EXC,  is  duplicated  in  SCNFIL,  so  that  the  zero  fill  lines 
at  the  top  of  the  image  are  mapped  as  though  they  were  real  data. 
SREG  now  calls  TOTAPE  to  write  the  full-scaled  IR  scan  to  tape 
(MT2)  if  the  IR  registered  output  tape  was  requested  by  the  oper- 
ator in  the  SRE  phase  and  SREG  is  currently  working  with  the  IR 
data.  SREG  then  calls  TODISK  to  output  the  registered  scan  to 
disk.  The  data  output  to  disk  is  compressed  (i.e.,  every  fourth 
output  scan  is  picked  up  by  TODISK  and  then  every  fourth  PIXEL  m 
that  scan  is  moved  to  the  disk  output  buffer,  DSKBUF) . This  re- 
sults in  a total  output  of  550  scan  lines,  each  with  625  PIXEL'S. 
When  TODISK  determines  it  is  to  use.  a scan  of  data  (i.e.,  every  - 
fourth  scan,  it  calls  BLDBUF  to  build  the  compressed  scan  in 
DSKBUF.  At  this  point,  an  emissivity  correction  is  applied  to 
each  PIXEL  in  the  output  scan  if  the  program  is  working  on  IR 
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Figure  3-33  SREG  Expansion  Logic 
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channel  data.  A background  emissivity  image  map  resides  perma- 
nently on  DK1 : the  registration  background  map  disk.  TODISK 

reads  in  the  corresponding  scan  of  emissivity  correction  data 
from  disk.  BLDBUF  calls  an  assembly  routine,  EMI  SIT,  to  take 
every  fourth  PIXEL  in  the  output  scan,  do  the  emissivity  correc- 
tion, and  place  the  result  in  the  output  buffer  DSKBUF . The  for- 
mula for  this  correction  is: 

RESULT  = (IOVAL-80)  * (IPIX+404)  * 0.000274838  + 0.5 
Where: 

IPIX  = PIXEL  value  in  the  output  buffer  (OUTBUF) 

I OVAL  = Emissivity  correction  factor  PIXEL  value  as  picked  up 
from  the  background  image  map  for  PIXEL  IPIX. 

Then : 

NEWPIX  = IPIX  + RESULT 


Where  NEWPIX  = 0,  255 

TODISK  exits  to  SREG  to  process  the  next  output  scan.  When  TODISK 
has  accumulated  four  compressed  registered  scans  m DSKBUF  t 
buffer  is  written  to  the  disk  file  SEDREG  So  for  every  16  out- 
put scans  built  in  OUTBUF  (i.e.,  every  16th  call  to  TDISK)  four 
compressed  scans  are  built  and  output  to  disk  via  NTRAN  DOS  I/O. 

TODISK  is  also  responsible  for  setting  up  isothermal  output  (III 
channel  only)  as  requested  by  the  operator  in  the  SRE  phase.  Li 
isothermal  output  is  selected,  TODISK  checks  to  see  whether  normal 
or  four-to-one  compression  was  requested.  If  normal  compression 
was' requested,  for  each  call  to  TODISK  via  SREG  the  full-scale 
registered  scan  in  OUTBUF  is  moved  to  the  second  half  of  DSKBUF 
(i.e.,  DSKBUF  + 2500).  See  figure  3-34  for  the  format  of  the 
DSKBUF  data  module.  DSKBUF  is  mapped  in  via  a SEG  call  when 
necessary  for  data  scan  transfer  for  isothermal  output  and/or 
disk  output.  TODISK  then  calls  the  isothermal  output  module 

ISOMOD  via  SEG. 
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COMMON/DSKBUF/IWORD  (1250),  IDATA  (1250) 


I WORD: 


IDATA: 


COMPRESSED  4 TO  1 
REGISTERED  DATA  SCAN 

COMPRESSED  4 TO  1 

REGISTERED  DATA  SCAN 

COMPRESSED  4 TO  1 

REGISTERED  DATA  SCAN 

COMPRESSED  4 TO  1 

REGISTERED  DATA  SCAN 

FULL-SCALE  REGISTERED 
DATA  SCAN 


J 


Figure  3-34  DSKBIIF  Data  Module 


6251q  PIXELS 


2500, n PIXELS 
10 
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ISOMOD  retrieves  the  scan  from  DSKBUF  and  calls  PDGEN  to  output 
•the  data  to  tape  (MTO)  and/or  display  on  the  ICD  (interactive 
color  display) . PDGEN  and  other  assembly  routines  linked  within 
the  ISOMOD  load  module  accomplish  all  isothermal  products  genera- 
tion. These  routines  are  available  for  generation  of  various  SEDS 
products  and  are  discussed  in  paragraph  5.  2/3.1.  ISDMOD’s  main 
function  is  to  pick  up  the  data  for  output  and'provide  logic  to 
interface  with  the  product  generation  routines.  If  compressed 
output  is  selected,  TODISK  calls  the  ISOMOD  load  module  when  it 
has  built  four  compressed  scans  in  DSKBUF  (first  half) . ISOMOD 
makes  four  calls  to  PDGEN,  passing  one  compressed  scan  for  output 
for  each  call.  ISOMOD  returns  to  TODISK  via  a return  SEG  call. 

The  call  packet  set  up  for  PDGEN  passed  with  each  call  is  outlined 

in  figure  3-35. 

When  it  has  completed  registering  the  IR  and  VIS  channels  on  a 

day  pass  or  the  IR  channel  on  a night  pass,  SREG  performs  wrapup 

procedures  such  as  rewinding  all  input  and  output  tapes,  calling 
ERRDSP  to  output  a JOB  COMPLETE  message  to  the  VT05,  and  exiting 
to  the  SEDS  resident. 

3.2. 3.2  Flow  Charts.  See  60  pages  following  figure  3-35. 


3-239 


JSC-10019 
Part  II 


NORMAL  CALL  TO  PDGEN: 


A: 


JSR  R5,0#PDGEN 

BR  A 

.WORD  PDCMD 

.WORD  IS DAT 


It  14  IS  It 

11  10  t 

* 

1 t 

9 4 S t 

1 0 

PDCMD: 

^1 

■ 

IMAGE 

SIZE 

caa 

Emil 

+2 

TAPE  UNIT  NO. 

1 

+4 

+6 

4 

3 

+8 

5 

5 

1 

i.  j i — 

L—i 

l-  1 ,1  l— . 

1 1 1 

* IF  SET  = FIRST  TIME  THRU 


6-CHAR 
TAPE  NO. 
IN  ASCII 


ISDAT : 


It  14  IS  It  II  <0 

i — i — i — r « ■ i T 


t«? 

r~ 


**43110 

f— T— T— I— T ’T—~l — 


INPUT  DATA  ADDRESS 


WITHIN  DSKBUF 


OUTPUT  CODE  (BITS  0,  1): 

00  = NONE 

01  = DISPLAY 

10  = TAPE  ONLY 

11  - BOTH 

PRODUCT  CODE  (BITS  2-5): 

1000  * ISO  DAY  (OID) 

1001  = ISO  NIGHT  (OIN) 

1010  = CMI 

1011  = RAINFALL  (ORC) 

1100  = SCREWWORM  (OWC) 

1101  = SPECIAL 


IMAGE  SIZE  (BITS  6-7): 

00  = COMPRESSED  (625  PIXELS,  525  SCAN  LINES 

01  = NORMAL  (2500  PIXELS,  2200  SCAN  LINES) 

STATUS  (BITS  12-15): 

12  - IF  SET,  DISPLAY  TIME  OUT 

13  - IF  SET,  MANUAL  ABORT 

14  - IF  SET,  OPERATION  COMPLETE 

15  - IF  SET,  INVALID  TAPE  WRITE 


Figure  3-35 


Normal  PDGEN  Calling  Sequences 
and  Packet  Format 


reproducibility  of  the 
'TO8NAL  PAGE  IS  POOR 
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dn/ypor/z:  d<ur^  7777 
T^'p/V&ZaZ  7b  /TayZP' 
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3. 2. 3. 3 Interfaces 

A.  Input  Data.  Following  is  the  input  data  to  REG  which  is 
external  to  the  CPC. 

1.  The  input  image  tape  to  be  registered  is  the  primary 
input,  and  is  one  of  two  tapes: 

• EU  processed  tape  (SED) 

• Night  coarse  rotated  tape  (CRT) . 

2.  The  input  tape  header  record  is  read  in  to  use  in  build- 
ing the  output  header  for  the  registration  products  by 
REGHED. 

3.  The  COMMON/GCOEFF/  is  a resident  common  containing  GCP 
information  and  mapping  coefficients  to  be  used  by  SREG 
in  the  image  registration.  See  paragraph  3.1.5  for  a 
description  of  this  common. 

4.  COMMON/ TAPE ID/  is  a resident  common  with  the  operator- 
entered  tape  ID's  for  the  output  products  (see  para- 
graph 3.1.5).  These  ID’s  are  placed  in  the  output 
tape  header  record. 

5.  COMMON/PRFLGS/  is  a resident  common  containing  processing 
selection  flags  indicating  what  output  options  were  se- 
lected via  the  operator  (see  paragraph  3.1.5). 

B#  Output  Data.  The  output  data  of  REG  is  as  follows: 

1.  The  primary  output  of  REG  is  the  registered  disk  tile, 
containing  registered  data  for  the  day  IR  and  VIS 
channels  and  the  night  IR  channel  for  a particular 
day's  run  (two  passes).  Figure  3-36  is  a graphic  por- 
trayal of  the  disk  file  illustrating  its  format. 

2.  REG  outputs  a registered  IR  tape  containing  the  IR  full- 
scale  registered  data  scans.  See  figure  3-37  for  the 
format  of  the  IR  registered  data. 

3.  REG  outputs  an  isothermal  tape  containing  the  isothermal 
registered  scan  data  either  in  full-scale  or  compressed 
4:1. 
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FILE  NAME 


SEDREG.HDR  (5670g) 

HEADER  RECORD 
(30001q  BYTES) 

r 

(15,500a) 

RECORD  1 
(NIGHT  IR  DATA) 

(22,404g) 

RECORD  2 
(DAY  IR  DATA) 

(27,310g) 

RECORD  3 

(DAY  VISIBLE  DATA) 

J 

SEDREG.DAT 
(625  BYTES/ 
SCAN  LINE,  < 
4 SCAN  LINES/ 
RECORD) 

* 

f 

-X 

RECORD  412 
(NIGHT  IR  DATA) 

- > 

RECORD  413 
(DAY  IR  DATA) 

> 

RECORD  414 
(DAY  VISIBLE  DATA) 

J 

COMPRESSED  SCAN  LINES  1 
2500^  BYTES  (4704g) 


COMPRESSED  SCAN  LINES 
549-550,  2500-jq  BYTES 


Figure  3-36  Registered  Disk  File 
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*IRG  = INTER  RECORD  GAP 


1 H Figure  3-37  SEDS  Registered  9-Track  CCT  Format 
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C, 


Call  Sequence.  REG  is  called  from  the  SEDS  resident 
module  after  the  SRE  CPC  and,  if  applicable,  the  ROT 
CPC,  have  executed.  REG  is  called  by  SEDS  once  during 
the ' run  of  the  entire  Regis teration  Program. 


■<  2 V4  Data  Oreanization.  REG  contains  various  _types  of 
in  the  form  of  data  modules,  commons  unique  to  REG  for  use 
transferring  data  between  routines  and  subroutines, 
commons  unique  to  REG  but  residing  in  resident  to 
transfer  of  data  between  the  load  modules  of  REG. 


data 
in 

and  resident 
enable  the 
Also  included 


transfer  ui  ^ . r nrr 

arc  internally  defined  variables  in  the  various  routines  of  REG. 

A Data  Modules.  These  are  4K  data  block  areas  allocated  and 
mapped  into  core  via  SEG.  Any  load  module  can  map  m any 
of  these  data  modules,  thereby  allowing  them  to  use  data 
from  another  32K  virtual  memory  mapping  (i.e.,  load  module 
LDA) . In  REG,  there  are  the  following  data  modules. 


1.  INBUFF. 


This  is  a 2700iq  integer  word  data  buffer  re- 
siding in  a 4K  area  of  the  virtual  core  map.  It  is 
set  up  as  a double  buffer  in  which  the  input  tape  scan 
data  or  ancillary  data  is  read  into  by  READIN  one  scan 
at  a time.  The  dou  le  buffering  enables  the  program 
to  read  in  another  scan  while  processing  is  performed 
on  the  first  one. 


2.  DSKBUF . This 


is  a two-part  data  module  in  which  the 
registered  data  is  moved  for  output  of  disk  and  iso- 
thermal products.  It  contains  the  registered  data  in 
both  full-scale  and  4:1  compressed  form.  For  output  to 
disk,  four  compressed  scan  lines  are  gathered  by  the 
TODISK  Routine.  The  full-scale  scan  is  transferre  -o 
TDSKBUF  by  TODISK  if  the  isothermal  outputs  are  re- 
quested. Se£  figure  3-34  for  the  format  ci  DSKBUF. 

rqtbUF  This  rotation  buffer  consists  of  the  array 
I CHAFF  which  is  dimensioned  (1350,3),  using  4050  words 
of  a 4K  block.  The  4K  block  with  the  array  I CHAN  is 
repeated  18  times  in  physical  core,  for  a total  buf-^ 
fering  capacity  of  54  scan  lines.  Flags  and  pointers 
regulating  data  movement  through  the  rotation  buffer 
are  contained  in  COMMON / RE GWRK  and  are  as  follows. 


Reproducibility  op  i 
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iNDDio.  This  is  the  number  of  scans  needed  m th* 
rotation  buffer  to  resection  one  output  line.  Atte 


a.  NSETS. 


rotation  ^ - * , r 

NSETS  lines  have  been  stored  in  the  rotation  u » 
the  program  begins  outputting  lines,  one  line  out 
for  each  line  in.  The  NESTS  + 1 line  to  be  written 
in  the  rotation  buffer  is  written  where  line  1 was 
previously,  thus  making  the  buffer  rotate. 

b.  IBEGIN.  This  flag  is  set  to  1 in  SCNFIL  °^REG^ 
when  NSETS  lines  have  been  stored  m the  rotati 
buffer,  to  indicate  that  output  can  begin  because 
the  rotation  buffer  is  full  enouth. 


c . 


d. 


Ml.  This  is  the  scan  line  pointer  with  a range 
of  1 to  NSETS,  where  NSETS  £ 54. 


M2.  This 
of  1-18. 


is 


the  data  area  pointer,  with  a range 


e.  M3.  This  is  a pointer  to  the  scan  line  within  data 
area  M2.  It  has  a range  of  1-13. 


f.  MISTOR. 


This  is  the  previous  value  of  Ml,  used  on 


input  to  the  rotation  buffer. 

When  inputting  a line  to  the 

arSJd  earlier  Ml  incre- 

^2.frS!  ITU ^ines  is  bein* 

MX%3  - MOO  (MX.3,  M2  i,  u,.a  by 

SBC  to  map  in  the  daia  area.  When 

out put t ingC  a°  resect  ioned  line,  ..subroutine 

. . vr-1  mo  and  N3  in  a manner  similar  to  mat 
pointers  Nl,  anu  and  M3  are  m 

Ml,  M2,  and  M3  are  used  input  Ml,  M2  that 

rotation  bufter  Ml  is 

stored  in  have 

output  a resectioned  line.  me 


3-305 


JSC-10019 
Part  II 


some  PIXEL'S  from  each  of  the  NSETS  lines  in  the  rotation 
buffer.  The  line  that  was  just  put  in,  line  MISTOR,  will 
be  used  first.  N1  is  set  to  MISTOR,  N2  = Nl/3  if  3 divides 
Nl,  and  N2  = int  (Nl/3)  + 1 if  3 does  not  divide  Nl.  N3  = 

MOD  (Nl,  3).  , , .. 

area  N2  according  to  PXTBLE . Nl  is  decremented,  and  the 
process  is  repeated  until  the  output  scan  is  completed. 

B . Buffers  and  Commons  Unique  to  REG 

1.  HEDBUF  (INDAT.  This  is  1530iQ-word  integer  buffer  used 
to  build  and  output  the  registered  disk  header  file  by 
the  REGHED  load  module. 

2.  CHBUFF  (IDAT).  This  is  a 1350i(j-word  integer  buffer. 
Input  scan  data  is  moved  to  this  internal  buffer  by 
READIN  to  be  processed  by  SREG. 

3.  COMMON /STATUS/ . If  the  flag  I1STAT  = 0,  ancillary  and 
the  first  data  channel  is  read  in  by  READIN.  If  I1STAT 
= 1,  the  second  data  channel  is  read  in.  If  the  flag 
I2STAT  = 0,  normal  processing  is  performed.  If  12STAT 
= ] , an  EOF /EOT  has  been  encountered  and  processing  is 
stopped.  These  flags  are  set  by  READIN  and  checked  by 
SREG  to  control  the  sequence  of  processing. 

4.  COMMON/FIXCOM/ . This  common  contains  the  following. 

a.  SCNTME . A four -word  entry  for  the  time  of  the 
current  input  scan. 

b.  ISCAN.  A one -word  entry  for  the  current  input  scan 
number. 

c.  IRE CNO.  A one-word  entry  for  the  current  record 
number  cf  this  data  set  (as  input). 

d.  TMESAV.  A four-word  entry  for  the  time  of  the 
previous  scan. 
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e-  ISCSAV . A one-word  entry  of  the  scan  number  of  the 
previous  scan. 

f.  IRCSAV.  A one -word  entry  of  the  record  number  of 
the  previous  record. 

5.  OUTBUF.  This  is  a 1350^0  integer  word  buffer  used  as 
the  output  buffer  for  the  registered  data  scan.  It 
contains  : 

• IRCRD  - a one-word  entry  record  counter 

• IANCIL  - a 50-word  ancillary  block 

• ICHOUT  - a 1299-word  data  block. 

The  resectiQiied  data  scan  is  built  from  ROTBUF  to 
OUTBUF.  one  scan  at  a time. 

6.  TBLEPX.  This  54-word  integer  table  contains  entries 
for  each  line  in  the  rotation  buffer  specifying  the 
number  of  PIXEL'S  to  extract  from  each  scan  in  the 
rotation  buffer  to  build  one  output  resectioned  scan. 
This  table  is  initially  set  up  by  the  FORTRAN  subrou- 
tine PXTBLE. 

7.  COMMON/ REGWRK/.  This  common  contains  information  set 
up  and  used  by  SREG  in  the  data  manipulation  from 
ROTBUF  (discussed  previously),  and  data  words  used 
elsewhere  in  the  registration  process.  These  are  as 
follows. 

a.  NSETS.  The  computed  number  of  scans  needed  to 
store  in  the  rotation  buffer  (1-54). 

b.  Ml.  The  scan  line  pointer  in  ROTBUF  (1-54). 

c.  M2 . A 4K  data  area  pointer  (1-18)  used  by  SEG  to 
map  in  the  appropriate  4K  data  area  (ROTBUF)  from 
physical  core  to  the  virtual  32K  core  map. 
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d.  M3.  A pointer  to  the  scan  line  within  data  area 
M2  (1-13). 

e.  SD  ISP.  The  computed  scan  to  be  processed. 

f.  YSCAN.  The  scan  line  in  the  reference  grid  of  the 
next  scan  line  to  generate  for  output. 

g.  IIP,  IED.  The  starting  PIXEL  value  of  scan  SD  to 
place  in  the  rotation  buffer. 

h.  MISTOR.  This  contains  the  scan  number  of  the  last 
scan  that  was  scaled  and  translated  and  is  used  by 
R TAT  ON  subroutine. 

i.  1SNC0R.  The  corrected  scan  number. 

IBEGIN.  A flag  indicating  that  resectioning  is 
to  begin  because  the  rotation  bulfer  is  full. 

k.  CMPRS . A compression  factor  in  the  downtrack 

d:i  recti  on  (computed  by  SREG)  used  on  input  of  data 
to  the  rotation  buffer. 

l.  EXPAND.  A expansion  factor  to  restore  the  image 
to  2200  lines,  used  on  output  from  the  rotation 

buffer. 

m.  I COUNT,  NCOUNT . These  counters  are  used  by  SREG 
for  the  compression  loop. 

n.  T COUNT,  NN.  These  counters  are  used  by  SREG  Lor 
the  expansion  loop. 

8.  EMSSIV.DAT.  This  is  a disk  file  (550  scans  by  625 

PIXEL’S)  containing  emissivity  correction  factors  to  be 
applied  to  a formula  for  each  PIXEL  of  the  compressed 
registered  IR  data  image.  The  disk  file  resides  under 
UIC  200,200  on  the  DK1  background  image  disk.  TODISK 
reads  the  data  in  from  the  file  for  EMI SI f to  use  in 
performing  the  correction  of  the  IR  registered  data. 
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*.2.3.5  Limitations.  The  registration  module,  due  to  core  avail- 
ability, is  limited“to  a 54-scan  line  capacity  in  the  rotation 
buffer  ROTBUF.  Depending  on  the  amount  of  rotation  required,  1 
is  sometimes  necessary  to  compress  the  data  going  into  the  rota- 


tion buffer,  and  then  expand  it  on  output 
loss  of  data  resolution. 


This  results  in  some 


3. 2. 3. 6 Listings.  See  Part  IV  of  this  document,  published  under 
separate  cover. 


3-309 


JSC-10019 
Part  IX 


SECTION  4 

RAINFALL  ALGORITHM  PROGRAM  (RAP) 


4.1  PROGRAM  CHARACTERISTICS 

The  Rainfall  Algorithm  Program  (RAP,  or  Data  Base  Update  Sequence 
No.  1)  is  used  to  perform  daily  rainfall  estimation  calculations 
and  daily  mean  air  temperature  (DMAT)  calculations  to  build  a 
data  base  update  (delete)  tape,  to  build  an  imagery  tape  containing 
six  images  suitable  for  filming,  and  to  output  to  the  line  printer 
pertinent  information  pertaining  to  Mexican  and  U.S.  meteorologi- 
cal (MET)  weather  stations.  The  input  sources  to  RAP  are  as 
follows : 

• A disk  file  containing  three  channels  of  registered  satel- 
lite data 

• A crop  moisture  index  (CMI)  tape  of  Mexico 

• Input  cards  of  MET  station  data 

• Disk  files  containing  background  and  ground  truth  tempera- 
ture information 

• An  old  data  base  update  (delete)  tape  from  N days  ago, 
where  N is  the  length  of  the  data  base  maintained  in  SSP 
(Data  Base  Sequence  No.  2). 

The  data  base  update  tape  generated  by  RAP  with  each  day’s  pro- 
cessing serves  as  one  of  the  input  tapes  to  SSP.  This  tape 
contains  four  channels  of  old  and  new  CMI  and  DMAT  information, 
its  format  will  be  detailed  elsewhere  In  this  document.  The 
imagery  tape  output  by  RAP  contains  six  images  and  is  defined 
in  paragraph  5. 2. 3. 3 and  by  figure  5-24. 

RAP  consists  of  five  major  components  or  modules.  The  first 
module,  DBUINT , performs  initialization  and  user  control  of  card 
inputs.  The  second  module,  RAP  (not  to  be  confused  with  the 
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overall  program  name) , has  additional  user  control  through  the 
VT05.  It  serves  as  the  controlling  module  for  input/output  func- 
tions during  processing,  as  well  as  the  sequencing  and  scheduling 
of  the  remaining  three  modules  of  the  overall  RAP  Program,  which 
are  U9TRD,  RFTGEN,  and  METPRT.  Due  to  the  large  amount  of  in- 
struction and  buffer  space  required  to  accomplish  the  many  tasks 
defined  in  RAP,  the  use  of  segmentation  and  program  overlay  fea- 
tures were  fully  utilized.  The  function  of  the  last  three  modules 
are  therefore  somewhat  specilaized.  U9TRD  performs  input  buffer- 
ing and  tape  control  of  the  CMI  data;  RFTGEN  performs  product 
generation  of  the  six  images  output  to  the  ORC  tape;  and  METPRT 
performs  MET  station  data  save  on  disk  and  line  printer  output. 

In  addition,  RFTGEN  allows  one  of  the  six  images  output  to  tape 
to  be  monitored  via  the  SEDS  display.  The  basic  configuration 
of  RAP  is  described  by  figure  4-1. 

4.1.1  Functional  Allocation.  As  defined  in  the  functional  re- 

quirements for  SEDS  (PHO-TN734),  RAP  performs  the  output  pro- 
cessing product  No.  5:  maps  of  recent  rainfall.  The  first  phase 

of  the  data  base  update  and  maintenance  processing  is  performed. 

The  new  data  base  update  tape  generated  daily  by  RAP  contains 

CMI  and  DMAT  information  necessary  for  the  complete  data  base 
computations  and  archive  processing  accomplished  in  SSP.  When 
the  data  base  length  is  set  at  a fixed  value  (N) , the  new  update 
tape  contains  four  channels.  Channels  1 and  2 are  current  values 
of  CMI  and  DMAT.  Channels  3 and  4 are  old  values  of  CMI  and  DMAT 
from  the  old  data  base  update  tape  of  N days  ago.  The  CMI  data 
is  not  changed  by  RAP,  but  is  carried  forth  to  be  put  on  the  up- 
date tapes  in  appropriate  channels.  Design  and  hardware  limita- 
tions made  RAP  the  convenient  place  to  input  the  CMI  information. 
The  calculations  of  the  SEDS  DMAT  values  are  performed  exclusively 
in  RAP.  All  DMAT  information  is  in  the  form  of  8-bit  values  with 
a range  of  0-255.  The  256-place  increments  represent  1/4  °K 
temperature  steps.  One  count  = 260.25  °K,  and  255  counts  = 323.75 
°K.  The  DMAT  for  each  day's  processing  is  color-coded  and  is 
processed  as  OWC  product  No.  6 in  SSP.  The  DMAT  will  be  determined 
for  each  PIXEL  from  the  current  day’s  day  IR  and  night  IR  data 
retrieved  from  the  disk  files  built  by  the  SEDS  registerat ion 
program. 

4.1.2  Program  Flow  Chart.  See  figure  4-2. 
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Figure  4-1  RAP  Basic  Configuration 
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Figure  4-2  RAP  Program  Flow  Chart 
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4.1.3  Timing  and  Sequencing.  RAP  is  designed  to  be  executed 
following  the  registration  of  both  night  and  day  passes.  In 
the  normal  day's  production  cycle,  the  registered  data  on  disk 
from” re gistrationP serves  as  one  of  the  inputs  to  RAP.  Following 
SEDS  initialization  of  RAP,  the  user  is  required  to  properly  con- 
figure before  starting  RAP.  This  includes  such  items  as  having 
the  disk  containing  registered  and  static  data  ready,  all  M 
station  cards  available,  and  input  and  output  tapes  mounted  on 
designated  tape  drives.  Additional  program  setup  may  be  made 
through  selected  VT05  entries.  Once  initialization  and  setup  is 
complete,  program  execution  is  started  and  continues  for  about  20 
minutes.  The  source  data  is  from  cards,  disk,  and  tapes  containing 
CMI  and  old  DMAT  information.  The  disk  files  and  input  tapes  con- 
tain 550  scan  lines  of  information.  Each  scan  line  has  625  PIXELS, 
sequence  of  tape  input/output  and  disk  reads  and  writes.  Data  is 
read  and  written  to  disk  four  scan  lines  at  a time.  The  data  to 
be  color-coded  and  formatted  for  product  output  is  passed  to 
RFTGEN  for  product  generation  for  each  scan  line.  Following 
cyclic  operations,  the  MET  station  reports  are  output  to  the  line 
printer  and  pertinent  data  saved  on  disk.  The  new  update  tape 
has  now  been  generated  and  SSP  processing  may  be  starte  . 

4 1.4  Storage  Allocations.  The  storage  requirements  for  RAP  are 
illustrated  by  figure  4-37  As  shown  by  the  diagram,  all  component 
modules  except  U9TRD  require  12K  core  storage  for  instruction 
space  and  internal  buffers  and  constants.  All  five  modules  use 
one  or  several  4K  segmentation  buffers  for  passing  data  from  one 
module  to  the  other.  The  4K  buffers  used  by  RAP , REGBUF  and 
GRDBUF,  contain  four  scan  line  blocks  of  registered  imagery,  an 
four  scan  line  blocks  of  background  data  used  in  maintaining  the 
current  ground  truth  temperature  when  satellite  data  is  missing. 
The  layout  of  REGBUF  and  GRDBUF  is  shown  m figure  4-4.  The  4K 
buffer  ORCBUF  is  used  as  the  products  calculations  transfer  buf- 
fer and  work  area  for  the  six  ORC  images. 

4,1.5  Data  Base  Characteristics 


A. 


File  Description.  The  common  files  of  RAP  consist  of  ^ 
two  common  storage  blocks,  SCOMVT  and  DBDAT1.  The  first 
area  is  used  by  most  programs  and  modules  in  SEDS  because 
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Figure  4-3  RAP  Storage  Allocation 
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it  contains  VT05  and  universal  format  tape  read  flags  and 
constants.  The  common  area  DBDAT1  is  unique  to  RAP.  It 
is  a 583-word  block  initialized  and  set  up  in  DBUNIT,  and 
is  referenced  and/or  modified  by  all  succeeding  components 
of  RAP.  The  exact  content  of  this  data  block  is  shown  by 
the  listing  printout  of  the  subcomponent  called  "DBUINT." 

B.  Program  Constants.  Several  sets  of  program  constants  re- 
side in  RAP,  ranging  in  size  and  number  from  the  rainfall 
coefficients  to  the  complex  DMAT  constants.  Some  are 
simple,  such  as  threshold  values  for  various  temperature 
conditions  or  the  number  of  MET  station  statistical  print- 
outs. These  groups  of  program  constants  are  further  ex- 
plained in  this  section  and  in  the  computer  program  list- 
ings (Part  IV). 
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4.2  RAP  CPC  CHARACTERISTICS 

This  paragraph  contains  a detailed  technical  description  of  the 
computer  program  components  (CPC’s)  identified  in  paragraph  4.1. 

The  instruction  listings  contained  herein,  by  inclusion  or  ref- 
erence specify  the  exact  configuration  of  RAP. 

4.2.1  DBUINT.  The  initialization  and  first  execution  component 
of  rap  is  DBUNIT.  User  control  of  card  inputs  and  VT05  entry  of 
MET  station  ID  updates  is  accomplished  in  this  module,  as  well  as 
normal  and  abnormal  program  termination.  The  module  is  comprised 
of  several  separate  and  distinct  subcomponents.  Two  of  these 
(DBUDRV  and  METCRD)  are  written  in  PDP-11  FORTRAN.  The  other 
subcomponents  are  written  in  PDP-11/45  assembly  language. 

4. 2. 1.1  Subcomponent  Descriptions 

A.  DBUDRV.  This  is  the  RAP  driver  routine  of  SEDS,  and 
exists  because  of  the  system  segmentation  and  overlay 
software  utilized  by  SEDS. 

B.  "DBUINT.”  This  is  the  primary  subcomponent  of  the  RAP 
module  DBUINT.  Initialization,  card  input  control,  and 
termination  are  the  primary  functions  of  the  DBUINT  module. 
User  control  is  through  the  VT05  terminal.  RAP  utilizes 
specially  developed  VT05  input/output  software.  Card  in- 
put ■ and  MET  station  ID  update  control  are  accomplished 
through  "yes"  or  "no"  responses  to  advisory  messages  out- 
put to  the  VT 0 5 . The  MET  station  ID  update  display  and 
the  RAP  initialized  VT05  control  display  are  shown  in 
figures  4-5  and  4-6,  respectively.  Through  VT05  user 
response,  program  control  is  passed  on  to  the  second  RAP 
module  (RAP)  for  processing.  Program  termination  is  back 
through  DBUINT  which,  via  user  response,  returns  to  the 
SEDS  residence  control  portion. 

C.  DBURT1  and  DBURT2.  These  are  two  source/object  subcompo- 
nents which  contain  several  subroutines  used  for  disk  and  ^ 
line  printer  interfacing  and  conversion  functions.  Included 
are  the  subroutines  DSKFIX  and  OUTDSK/ INDISK. 
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D DBUMSG.  This  is  the  source/object  subcomponent  which  con- 
tains”? re  defined  VT05  and  line  printer  messages. 

F METSP  This  is  the  source/obj ect  subcomponent  which  con- 
tains ' the  special  VT05  processors  used  in  updating  the  MET 

station  ID  display. 

F.  METTBL.  This  is  the  buffer  which  contains  the  MET  station 
ID’s. 

G METDSP.  This  is  the  coded  VT05  buffer  which  results  in 
the  output  of  the  MET  display  shown  in  figure  4-5. 

H.  DBUDSP . This  is  the  coded  VT05  buffer  shown  in  figure  4-6. 

I.  RFCOEF.  This  is  the  core-resident  buffer  showing  where 
the  rainfall  coefficients  reside  as  they  are  input  from 

disk. 

J.  METCRD.  This  is  the  MET  station  data  card  input  controlling 
routine  for  table  setup  for  RAP  processing. 

K TBINIT.  This  subcomponent  initializes  the  tables  used  in 
mm  for  line  printer  tabouts. 

I CKDATE.  This  subcomponent  checks  the  input  card  date 
against  the  date  of  the  registered  data  date  on  disk. 

M.  TABMET.  Tabs  out  the  stations  reporting  and  their  input 
DMAT/PRECIP  values  in  degrees  Kelvin  and  millimeters. 

N.  GONOGO.  Informs  user  via  the  VT05  the  status  of  card 
inputs  and  request  further  direction. 

O.  BLDTMT.  Builds  the  TMET  table  used  in  RAP  processing, 
and  'calculates  the  integer  encoded  values  for  the  card 
input  DMAT  values. 

4. 2.1.2  Flow  Charts.  See  the  following  26  pages. 
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4.2. 1.3  Interfaces 

A.  Input  Data.  Input  data  to  DBUINT  comes  from  three  sources- - 
card  input,  user  control  through  the  VT05,  and  disk.  Card 
inputs  of  MET  station  data  are  from  selected  U.S.  and 
Mexican  weather  stations.  The  lead  card  contains  the  date 
(MM-DD-YY)  of  the  MET  data.  The  following  data  cards  con- 
tain a MET  station  ID  number  (1-100) , a daily  mean  air 
temperature  in  °C  or  °F,  and  a 24-hour  total  precipitation 
measurement  in  inches  or  millimeters.  The  MET  station  in- 
put card  format  is  shown  in  figure  4-7.  User  inputs  are 
made  via  the  VT05  keyboard  for  changeable  fields,  allowing 
greater  flexibility  and  control.  The  ALT  key  is  used  to 
position  the  cursor  as . such  fields.  The  disk  files  ref" 
erenced  by  the  DBUINT  module  reside  on  the  system  disk 
(DK0)  under  users  identification  code  (UIC)  300,300.  The 
three  disk  files  are  METLOC.TBL,  DBINFO. TBL , and  RFCOEF.TBL 
and  each  file  is  one  block  (256  words)  or  less  in  length. 
The  detailed  format  of  these  files  may  be  determined  from 
the  program  listings  provided  in  Part  IV  of  this  document. 

B.  Output  Data.  The  output  of  the  DBUINT  module  consists 
only  of  the  internally  generated  messages  and  data  output 
to  the  VT05  and  line  printer  for  user  control. 

4. 2. 1.4  Data  Organization.  The  principle  internally  defined 
items  of  DBUINT  are  those  associated  with  the  VT05  changeable 
input  fields.  These  variables  are  discussed  in  paragraph  4. 2. 2.4. 


4.2.1. 5 Limitations . Operational  restraints  and  cilsk  xnpvit./ 
output  error  analysis  limit  the  complete  execution  of  DBUIN1 . 

The  operations  procedure  defined  by  the  current  SEDS  Operations 
Manual  require  the  user  to  follow  instructions  closely.  Int®rr°" 
gation' of  disk  I/O  errors  is  not  always  complete,  and  care  should 
be  taken  to  ensure  that  the  proper  system  and  data  disks  are 
used. 

4. 2. 1.6  Listings.  See  Part  IV  of  this  document,  published  under 
separate  cover. 
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DATA  CARD  1 


DATE  CARD 


DATE  CARD 


CONTENT 


DATE  OF  MET  DATA  IN  THE  FORMAT  MM-DD-YY  OR  MM  DD  YYj  INPUT  DOES  NOT 
HAVE  TO  RIGHT  OR  LEFT  JUSTIFIED.  FOR  EXAMPLE: 


1 2 3 4.  5.6,  7,8 
4'-l2l5l-l71S1': 


DATA  CARDS  (1-N) 


MET  STATION  ID;  MUST  BE  RIGHT-JUSTIFIED  BUT  NO  LEADING  ZEROS  NEED  BE 
INPUT 

DMAT ; CAN  BE  INPUT  IN  EITHER  OF  TWO  FORMATS: 

• INTEGER  - INPUT  MUST  BE  RIGHT-JUSTIFIED;  LEADING  ZEROS  OR 

DECIMAL  POINT  ARE  NOT  NECESSARY 

• FLOATING  POINT  - CAN  BE  INPUT  ANYWHERE  IN  THE  ALLOTTED  FIELD; 

MUST  CONTAIN  A DECIMAL  POINT 

ALPHA  CODE;  C = CENTIGRADE  INPUT  OF  DMAT,  F = FAHRENHEIT  INPUT  OF  DMAT, 
AND  A BLANK  DEFAULTS  TO  CENTIGRADE 

TOTAL  24  HOUR  PRECIPITATION;  CAN  BE  INPUT  IN  EITHER  OF  TWO  FORMATS, 

SAME  FORMATS  AS  LISTED  UNDER  DMAT  ABOVE 

ALPHA  CODE;  IN  = INCHES  OF  PRECIPITATION  INPUT,  MM  = MILLIMETERS  OF 
PRECIPITATION  INPUT,  AND  A BLANK  DEFAULTS  TO  MILLIMETERS 


END  CARD 

CHARACTER  E TO  INDICATE  THE  END  OF  THE  DATA  CARDS  IN  THE  CARD  DECK 


Oft  PftK'm'TATlON  FIELD  CAN  BE  LEFT  BLANK  IF  THE  INPUT  IS  NOT  AVAILABLE 

Figure  4-7  MET  Station  Data  Card  Format 
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4,2.2  RAP . The  second  module  of  the  RAP  Program  in  SEDS  is 
also  called  RAP.  This  module  provides  for  additional  user  con- 
trol through  the  VT05,  and  serves  as  the  processing  controller 
of  all  data  input  and  output  during  the  cyclic  operation.  The 
data  calculations,  as  well  as  sequencing  and  scheduling  of  disk 
and  tape  devices,  are  performed  in  the  RAP  module.  The  processing 
order  of  magnitude  is  about  625  PIXEL'S  of  550  scan  lines.  DMAT 
and  product  images  are  calculations  which  require  PIXEL-by-PIXEL 
control.  Tape  reads  and  writes  are  preformed  at  the  single  scan 
line  level.  Disk  input/output  operations  are  done  in  groups  of 
four  scan  lines.  The  RAP  module  is  composed  of  several  separate 
and  distinct  subcomponents.  For  arithmetic  convenience,  some 
routines  are  written  in  PDP-11  FORTRAN,  but  most  are  written  in 
PDP-11/45  assembly  language. 

4 . 2 . 2 . 1 Subcomponent  Descriptions 

A.  RAP DRV.  This  subcomponent  serves  as  the  linking  driver 
between  the  RAP  and  DBUINT  modules. 

B.  "RAP, " This  is  the  primary  subcomponent  of  the  RAP  module. 
User  control  not  completed  through  the  VT05  in  the  DBUINT 
module  is  continued  in  the  "RAP"  subcomponent.  Available 
input  and  output  tapes  and  tape  numbers  are  designated. 

The  user  is  also  required  to  enter  day  and  night  orbit 
numbers.  Changes  to  the  various  program  constants  and 
coefficients  are  made  at  this  time.  When  the  operator 
keys  in  the  CON  command  to  proceed,  the  cyclic  operation 
of  the  RAP  module  begins.  Tape  and  disk  I/O  and  data 
calculations  are  performed  for  550  scan  lines.  At  program 
termination,  control  is  returned  by  this  subcomponent  to 
the  DBUINT  module  for  further  user  direction  to  end  or 
restart. 

C.  DBSUB1 . This  source/object  module  contains  the  subroutine 
called  RAG,  which  performs  the  rainfall  estimation  algo- 
rithm. The  primary  function  of  the  subroutine  is  to 
determine  (by  temperature  evaluation)  if  a specified  PIXEL 
is  cloud-covered,  and  if  so,  to  determine  the  prediction 
of  the  rainfall  class  to  which  it  belongs.  One  of  five 
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rainfall  class  codes  will  be  determined  for  each  PIXEL 
ranging  from  dry  (Class  1)  to  heavy  rain  (Class  5).  The 
visible  data  and  day  IR  bands  for  the  same  pass  are  used 
with  a series  of  coefficients  to  determine  these  rainfall 
classes. 

D.  DBSUB2.  This  subcomponent  is  called  by  RAP  via  the  label 
DMATRT  once  per  PIXEL,  immediately  after  the  rainfall  clas- 
sifier in  DBSUB1  has  written  the  rainfall  color  code  for 
this  PIXEL  in  the  rainfall  map  buffer.  The  primary  func- 
tion of  DBSUB2  is  to  calculate  the  daily  mean  air  tempera- 
ture. It  selects  day  IR,  night  IR,  or  both,  as  inputs  for 
the  DMAT  calculation,  based  on  a series  of  tests.  It  then 
calls  a FORTRAN  subroutine  to  do  the  actual  calculation. 

If  neither  day  IR  or  night  IR  passes  all  the  tests,  DBSUB2 
uses  ground  truth  data  for  calculating  DMAT.  DBSUB2  per- 
forms the  following  steps. 

1.  DBSUB2  checks  the  color  code  in  the  rainfall  map  buffer 
to  see  if  day  IR  is  rainfall  Class  1 (clear) . 

2.  If  so,  DBSUB2  does  the  day  IR  threshold  test.  If  the 
data  fails  the  threshold  test,  DBSUB2  changes  the  color 
code  in  the  rainfall  map  buffer  to  Class  6. 

3.  If  night  IR  data  is  present,  DBSUB2  checks  it  against 
threshold  and,  if  it  fails  the  threshold  test,  writes 
color  code  6 in  night  cloud  map  buffer. 

4.  If  all  tests  have  been  passed  so  far,  DBSUB2  checks 
against  the  ground  truth  threshold. 

5.  DB.SU B 2 then  sets  FLAG1  (the  ground  truth  threshold 
flag)  for  use  in  the  MET  printout. 

6.  If  the  day  IR  data  failed  the  ground  truth  threshold 
test,  DBSUB2  changes  the  color  code  in  the  rainfall 
map  buffer  to  Class  7. 

7.  If  the  night  IR  data  failed  the  ground  truth  threshold 
test,  DBSUB2  writes  color  code  7 in  the  night  cloud 
map  buffer. 
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8.  If  the  night  IR  data  passed  all  the  tests,  DBSUB2 
writes  color  code  1 (clear)  in  the  night  cloud  map 
buffer. 

9.  If  both  day  IR  data  and  night  IR  data  failed  the 
ground  truth  threshold  test,  DBSUB2  decrements  PDELT 
(the  delta  T value)  by  the  value  of  DDT. 

10.  If  either  day  IR  data  or  night  IR  data  (or  both) 
passed  all  the  tests,  DBSUB2  calls  one  of  three 
FORTRAN  subroutines  for  the  DMAT  calculation.  It 
calls  DMTCAL  if  both  day  and  night  data  passed, 

DCASE2  if  only  day  IR  data  passed,  and  DCASE3  if  only 
night  IR  data  passed. 

11.  DBSUB2  sets  FLAG2  (DMAT  source  flag)  for  use  in  the 
MET  printout. 

12.  If  DMAT  is  not  calculated  from  the  IR  data,  and  if 
ground  truth  data  is  present,  DBSUB2  calculates  DMAT 
from  the  ground  truth  data. 

13.  DBSUB2  sets  the  QUAL  flag  in  the  most  significant 
byte  of  DMAT. 

14.  DBSUB2  updates  delta  T (PDELT)  for  disk  storage. 

15.  DBSUB2  then  writes  TGT , QUAL,  TMET,  and  PDELT  in 
their  respective  color  image  buffers. 

E.  DBSUB3.  This  is  the  source/obj ect  module  that  contains 
the  subroutines  DSKFIX,  OUTDSK/INDISK , RHEAD,  and  RECRD. 
The  first  two  subroutines,  which  deal  with  disk  file 
communication,  have  been  previously  described  in  paragraph 
4. 2.1*1.  The  last  two  subroutines  serve  to  call  in  the 
CMI  universal  format  module  for  tape  input.  RHEAD  is 
called  during  the  first  time  through  or  to  read  the  header 
record.  RECRD  is  called  repeatedly  for  each  scan  line 
from  the  CMI  tape. 


4-45 


JSC-10019 
Part  II 


F.  DBSUB4.  This  is  the  source/object  module  that  contains 
the  subroutines  METSAV,  PRTOUT , MOVPRT,  CVTDAT,  CVTASC, 
CVTOCT,  and  EJTPAG.  The  last  six  subroutines  were  de- 
scribed with  detailed  flow  charts  under  the  DBUINT  module, 
paragraph  4.2.1.  The  subroutine  METSAV  is  called  for  each 
PIXEL  for  MET  station  verification.  If  a PIXEL  is  deter- 
mined to  be  a MET  station,  pertinent  information  is  saved 
for  line  printer  output  at  the  end  of  the  RAP  execution 

run. 

G.  DMTCAL.  This  is  a FORTRAN  subroutine  called  by  DBSUB2 
to  calculate  DMAT  when  both  day  IR  and  night  IR  data  is 
usable.  Parameters  passed  to  DMTCAL  are  day  IR  and  night 
IR  values  (integers),  the  altitude  for  this  PIXEL  (an 
integer  which  DBSUB2  has  gotten  from  the  altitude  back- 
ground map),  the  floating  point  regression  constant  AOCOE, 
and  three  floating  point  regression  coefficients--AlCOE, 
A2C0E , and  A3C0E.  DMAT  is  calculated  in  floating  point  in 
DMTCAL,  converted  to  integer,  and  returned  to  DBSUB2  as  an 
integer  word,  with  a value  between  0 and  255. 

H.  DCASE2.  This  subroutine  is  similar  to  DMTCAL,  except  that 
it  is  called  when  only  day  IR  data  is  useable.  The  re- 
gression constant  and  two  coefficients  here  are  BOCOE, 
B1C0E , and  B2C0E. 

I.  DCASE3.  This  subroutine  is  similar  to  DMTCAL  except  it 
is  called  when  only  night  IR  data  is  usable.  The  regres- 
sion constant  and  two  coefficients  here  are  COCOE,  C1C0E, 
and  C2C0E . 

j.  COREBF.  This  source/object  subcomponent  defines  and 
reserves  the  core  space  for  most  of  the  core-resident 
buffers  required  by  the  RAP  module.  Details  of  the  lay- 
out are  shown  in  figure  4-8. 

K.  DBUMSG , METTBL , ST0C1.  ST0C2 . and  EB2CVT . These  subcompo- 
nents  of  the  RAP  module  have  been  previously  described  in 
detail  in  other  sections  of  this  document. 

• - { 

4.2.2. 2 Flow  Charts.  See  43  pages  following  figure  4-8. 
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Lgure  4-8  RAP  Module  Core-Resident  Buffers 
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4. 2. 2. 3 Interfaces 

A.  Input  Data.  The  input  data  to  the  RAP  module  of  the  RAP 
Program  comes  from  three  sources  --  user  input  via  the 
VT'05,  9-track  magnetic  tapes,  and  static  and  dynamic  disk 
files.  The  user  inputs  are  made  via  the  VT05  keyboard  into 
changeable  fields.  The  ALT  key  is  used  to  position  sequen- 
tially to  these  entry  positions.  The  tape  inputs  are  from 
the  old  data  base  update  and  the  CMI  tapes.  The  CMI  tape 
is  in  the  universal  format,  containing  one  channel  of  625 
PIXELS  for  550  scan  lines.  The  tape  format  of  the  data 
base  update  tape  is  unique  to  SEDS  and  is  defined  by  fig- 
ure 4-9.  The  tape  contains  551  records.  The  15-word 
header  record  (see  figure  5-5)  is  followed  by  550  data 
records  containing  2501  words.  The  first  word  of  each 
data  record  contains  a scan  line  counter  of  1 to  550. 

Four  channels,  each  consisting  of  625  words,  make  up  the 
remainder  of  each  data  record.  The  disk  files  referenced 
by  the  RAP  module  are  the  same  files  mentioned  as  input 
data  to  the  DBUINT  module. 

B.  Output  Data.  The  output  data  of  the  RAP  module  consists 
of  the  calculated  DMAT  values  from  the  day  IR  and  night 
IR  registered' data  for  each  PIXEL.  The  newly  generated 
DMAT  values  are  output  to  the  new  update  tape  as  the  "new" 
DMAT  channel.  The  "new"  CMI  channel  is  the  same  data  in- 
put from  the  CMI  tape.  The  "old"  channels  on  the  new  up- 
date |are  the  "new"  channels  of  the  old  update  tape  gener- 
ated L days  ago,  where  L is  the  data  base  length.  The 
delta  T disk  file  is  updated  daily  for  each  RAP  execution 
run.  The  values  from  the  delta  T disk  file  are  used  in 

the  estimation  of  the  DMAT  for  a given  PIXEL  when  the  satel- 
lite data  is  missing  due  to  cloud  cover  or  no  data.  The  six 
images  output  to  the  ORC  tape  are  calculated  PIXEL-by- 
! PIXEL  in  the  RAP  module. 

4. 2. 2.4  Data  Organization.  One  set  of  internally  defined  items 
in  the  RAP  module  are  those  associated  with  the  VT05  changeable 
fields.  The  list  of  items , described  in  table  4-1,  shows  the 
initialized  or  defaulted  conditions,  as  well  as  the  range.  There 
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TABLE  4-1 

RAP  VT05  PARAMETERS 


NAME 

TYPE 

DEFAULT 

LIMIT 

DESCRIPTION 

UMODE 

ASCII 

U 

I ,M»U,Z 

DATA  BASE  UPDATE  PROCESS  MODE  D 

ODBSIZ 

NUMERIC 

— 

0-99 

DATA  BASE  LENGTH 

PRTCNT 

NUMERIC 

0-99 

NO.  OF  COPIES  OF  MET  STATION  P/0 

REGAVL 

ASCII 

A 

A,D,N,X 

REGISTERED  DISK  DATA 

RDATE 

ASCII/NUM. 

O0-XXX-OO 

DD-MMM-YY 

DATE  OF  DELTA  T IMAGE 

DORBIT 

NUMERIC 

OOOOO 

0-32767 

DAY  PASS  ORBIT  NO. 

NORBIT 

NUMERIC 

00000 

0-32767 

NIGHT  PASS  ORBIT  NO. 

ODBTNO 

ASCII 

6 CHARS 

NEW  UPDATE  TAPE  NO. 

RFTNO 

ASCII 

6 CHARS 

OWC  TAPE  NO. 

AXX 

NUMERIC 

CURRENT 

15  RAINFALL  COEFFICIENTS 

RTHSIG 

ASCII 

CURRENT 

+ OR  - 

RAINFALL  THRESHOLD  SIGN 

THRLD 

NUMERIC 

CURRENT 

±32766 

RAINFALL  THRESHOLD 

NIRTH 

NUMERIC 

CURRENT 

0-999 

NIGHT  IR  THRESHOLD 

DIRTH 

NUMERIC 

CURRENT 

0-999 

DAY  IR  THRESHOLD 

KDAYSG 

ASCII 

CURRENT 

+ OR  r 

DAY  TEMPERATURE  THRESHOLD  SIGN 

KDAYIN 

" 

NUMERIC 

CURRENT 

0-120 

DAY  TEMPERATURE  THRESHOLD 

KNITSG 

ASCII 

CURRENT 

+ OR  - 

NIGHT  TEMPERATURE  THRESHOLD  SIGN 

KNITIN 

NUMERIC 

CURRENT 

0-120 

NIGHT  TEMPERATURE  THRESHOLD 

MINDLX 

NUMERIC 

CURRENT 

0-255 

DELTA  T IMAGE  UPDATE  CONSTANT 

DDX 

L 

NUMERIC 

CURRENT 

0-255 

DELTA  T IMAGE  UPDATE  CONSTANT 
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are  many  other  internally  defined  symbols  in  the  RAP  module,  and 
they  are  described  by  the  program  listings  provided  in  Part  IV 
of  this  document. 

4.2. 2. 5 limitations.  The  configuration  setup,  as  shown  by 
figure  4-1 , is  definitive  in  that  specified  input  and  output 
tapes  must  be  mounted  on  the  designated  tape  drives.  To  assist 
the  user  and  keep  him  informed  of  program  execution  status,  a 
series  of  advisory  messages  output  to  the  VT05  and/or  line  printer 
are  listed  in  table  4-2. 

■4. 2. 2.6  Listings  . See  Part  IV  of  this  document,  published  under 
separate  cover. 

4.2.3  U9TRD.  The  third  execution  module  of  RAP  is  U9TRD,  not  to 
be  confused  with  its  subcomponent  "U9TRD. " All  interfaces  with 
this  module  in  RAP  are  by  internal  software.  Basically,  the  mod- 
ule provides  the  function  of  tape  read  input  of  the  CMI  universal 
format  CCT.  Only  two  subcomponents  comprise  this  module.  U9TRD 
is  written  in  PDP-11  FORTRAN,  and  "U9TRD"  is  written  in  PDP-11/ 

45  assembly  language. 

4. 2. 3.1  Subcomponent  Descriptions 

A.  U9TDRV.  This  subcomponent  serves  as  the  linking  driver  to 
the  RAP  and  U9TRD  modules. 

B.  "U9TRD."  This  is  the  primary  subcomponent  of  the  module 
U9TRD , and  is  a universal  format  tape  read  routine.  It 
is  described  in  paragraph  6. 2. 1.1, C. 

4. 2. 3. 2 Flow  Chart . See  page  following  table  4-2. 
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TABLE  4 
RAP  ADVISORY  I 


N mi 

MESSAGE  < 

IPMSG 

INITIALIZATION  PHASE 

IPBMSG 

INCREASE  DATA  BASE 

DDBMSG 

DECREASE  DATA  BASE 

NDBMSG 

NORMAL  DATA  BASE  UPDATE 

RDNA 

REGISTERED  DISK  NOT  AVAILABLE 

MUDMSG 

MET  UPDATE  DISPLAY  REQUIRED? 

TAPERM 

TAPE  ERROR  ON  HEADER  RECORD! 

HDRERM 

HEADER  RECORD  ERROR 

UDBERM 

DATA  BASE  SIZE  ERROR! 

OPIERR 

OPERATOR  INPUT  ERROR! 

TSCERM 

TAPE  STATUS  CODE  ERROR 

UPTERM 

OLD  UPDATE  TAPE  READ  ERROR! 

LOSERM 

LOST  TOO  MANY  SCAN  LINES! 

DEVERM 

TAPE  READ  DEVICE  ERROR 

ENDMSG 

END-OF-RUN:  NORMAL  COMPLETION 

GOMSG 

ENTER  A-GO-COMMAND  WHEN  READY! 

UDTMSG 

UPDATE  TAPE  AVAILABLE? 

RESTEND 

ENTER  -RST--  OR  -END-  COMMAND! 

EOJMSG 

END-OF-JOB:  NORMAL  COMPLETION 

EOJERR 

END-OF-RUN:  ABNORMAL  EXIT! 

DSKERR 

DISK  READ-WRITE!!! 

LPERRM 

LINE  PRINTER  ERROR!!!  I 
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4. 2. 3. 3 Interfaces 

A.  Input  Data.  The  input  data  to  the  U9TRD  module  comes  via 
the  RAP  module  as  the  call  packet  to  the  subcomponent 
"U9TRD." 

B.  Output  Data.  The  output  data  of  the  U9TRD  module  is  a 
buffer  address  pointing  to  the  start  PIXEL  number  of  the 

| current  scan  line  from  the  CMI  tape, 

I ' 

4.2. 3.4  Data  Organization.  The  calling  packet  to  the  U9TRD  mod- 
ule is  placed  in  specified  memory  locations  in  the  SEDS  common 
area  named  SCOMVT,  When  the  first  word  of  the  "U9TPAK"  is  set 
nonzero,  it  signals  the  U9TRD  module  that  control  for  input  and 
output  parameters  is  located  in  the  designated  locations  of 
SCOMVT.  With  the  exception  of  "U9TPAK,"  entries  in  the  call 
packet  are  explained  by  figure  6-4  of  this  document.  The  "U9TPAK" 
packet  is  shown  beiow. 

. CSECT  SCOMVT 


.BLKW 

80. 

U9TPlAK: 

. B LKW 

1 

(set  nonzero  by  user) 

. BLKW 

3 

(used  by  U9TRD) 

PACKET : 

.BLKW 

6 

(tape  read  control  info) 

DATADR: 

.BLKW 

1 

(return  adr  of  start  PIXEL  No. 

STATUS : 

.BLKW 

1 

(status  code  returned) 

CHADR: 

.BLKW 
. CSECT 

8 

(channel  packet) 

4. 2. 3. 5 Limitations . The  primary  limitation  of  the  U9TRD  com- 
ponent of  RAP  is  that  extra  time  is  required  for  the  tape  input 
function  because  of  the  segmentation  feature  of  the  core  overlay 
with  each  scan  line. 

4.2. 3.6  CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 

4.2.4  RFTGEN . The  fourth  and  product  generation  module  of  RAP 
is  RFTGEN.  Its  function  is  the  product  generation  of  the  six 
images  output  to  the  ORC  tape.  The  module  is  composed  of  several 
separate  and  distinct  subcomponents.  With  the  exception  of  the 
FORTRAN  linking  driver,  PDGDRV,  all  subcomponents  are  written  in 
PDP-11/45  assembly  language. 
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4.2.4. 1 Subcomponent  Descriptions.  All  of  the  subcomponents  of 
the  RFTGEN  module  except  PDGDRV  are  discussed  in  paragraph  5. 2. 3.1, 
under  the  SWPGEN  module  of  SSP.  (They  include  PDGEN,  FCGEN , 

OWCPRO,  OWCTBL , U9WRT , DISPL,  FCTBL , OPNOT,  and  ANNOT.)  PDGDRV 

is  the  linking  driver  between  the  RAP  module  and  the  RFTGEN  mod- 
ule. 

4.2.4. 2 Flow  Chart.  See  following  page  for  a PDGDRV  flow.  De- 
tailed flow  charts  for  other  subcomponents  of  RFTGEN  are  shown  in 
paragraph  5.2. 3.2. 
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4. 2.4.3  Interfaces > The  basic  interface  of  the  various  product 
generation  subroutines  is  shown  by  figure  5-22.  One  call  to  the 
product  generation  module  (RFTGEN  for  RAP)  is  made  for  each  scan 
line.  The  buffering  is  set  up  so  that  the  data  from  all  six 
images  (as  detailed  in  figure  4-8)  is  moved  into  a 4K  buffer  area, 
ORCBUF,  for  communication  with  RFTGEN.  The  tape  format  for  the 
ORC  products  is  illustrated  by  figure  4-10. 

4. 2. 4. 4 Data  Organization.  The  principle  internally  defined 
items  of  the  RAP  product  generator  module  are  those  associated 
with  the  VT05  display  (see  figure  4-11).  A list  of  VT05  variable 
fields  with  initialized  values  is  shown  in  table  5-16. 

4. 2. 4. 5 Limitations . The  limitation  of  the  ORC  product  genera- 
tion capability  is  the  output  to  tape  of  all  six  images.  No 
selection  is  available  to  permit  the  output  of  only  one  or  two 
of  the  images.  The  only  recovery  capability  is  complete  restart 
feature  for  processing  from  scan  line  1 to  scan  line  550,  se- 
quentially. 

4. 2.4.6  CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 

4.2.5  METPRT.  The  fifth  and  last  component  of  RAP  is  METPRT. 
Selected  PIXEL  positions  within  given  scan  lines  are  defined  as 
MET  stations.  This  module  in  RAP  performs  specific  calculations 
on  this  data  and  outputs  to  the  line  printer  a user-defined  num- 
ber of  MET  station  report  copies.  Two  of  the  three  subcompo- 
nents --  "METPRT"  and  STNDEV  - - are  written  in  PDP-11  FORTRAN. 
CODIT  is  written  in  PDP-11/45  assembly  language. 

4. 2. 5.1  Subcomponent  Descriptions 

A.  "METPRT. " This  is  the  primary  subcomponent  of  the  METPRT 
module.  The  entire  MET  station  report  is  keyed  off  of 
the  predefined  identification  number.  MET  station  ID's 
may  also  be  defined  in  the  GTZONE  background  file,  which 
is  defined  on  disk.  In  addition,  information  reported 
via  cards  input  in  the  DBUINT  module  is  reflected  in  the 
MET  station  report  printouts.  The  principle  purpose  of 
the  reports  has  been  for  the  use  of  SEDS  evaluation  and 
validation. 
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Figure  4-10  RAP  PFC  Tape  Format  (ORC) 


SIDS  PRODUCT  GENERATION 

RAINFALL  DATE!  0l.HAR.75 

M0DE=3  DISPLAY  IMAGE*!  COMPRESSED  MTU*2 

O-NONE  CURRENT  SCAN  LlNEaOOOl 

l.DISPLAY 

2*TAPE  1«RAINFALL  RSTMEfC ID) 

1.0OTH  2«TGT  5«QUAL 

3»DELTA  T 6«NIGHT  CLD 


SYS  IOaSEDS  TAPE  ID«ORC  . SEQ.  NO,«Ol 

SEN  IDaNOAA  GEN  DATE»0 t-03-75  TAPt  NOa+MaS*  0RIXT*123A5 

JOB  IDsSEDS  IMAGE  RAINFALL  DATE  OF  DATA«02«2S-75 


FILM  ANNOTATION  COMMENT 

> ' . '"j  r;"";" 1 ■< 


^ FCTsOl  Aa»Q  t , 00  Ba+pop 


Figure  4-11  RAP  Product  Generator  Display 
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i ' ....  , 

B.  CODIT.  This  is  a short  subcomponent  for  the  purpose  of 
getting  the  rainfall  code  printed  out  on  the  report. 

C.  STNDEV.  This  is  the  subcomponent  that  calculates  the 
DMAT  standard  deviation  that  is  reflected  in  the  DMAT 
error  statics  summary  at  end  of  the  printout. 

4.2. 5.2  Flow  Chart.  See  following  21  pages. 
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4.2. 5. 3 Interfaces 

A,  Input  Data.  The  input  data  for  the  METPRT  component  is 
from  two  original  sources,  disk  files  and  input  cards. 
However,  most  of  the  information  reflected  on  the  print- 
out is  computed  information  from  these  sources. 

B.  Outputs  Data.  The  output  , data  is  routed  to  the  line  printer 
as  hardcopies.  A disk  file  is  also  created  and  updated  to 
reflect  the  MET  station  report  information.  This  disk  file 
is  for  historical  purposes  for  analysis  use.  Figure  4-12 
is  a sample  copy  of  the  SEDS  MET  station  report. 

4.2. 5. 4 j Data  Organization.  The  data  organization  of  the  METPRT 

module  iS  based  On  the  number  of  MET  station  ID’s  currently  de- 
fined in  SEDS.  The  upper  limit  of  the  number  of  ID's  has  been 
100,  with  the  ID's  ranging  from  0 to  99.  Basically,  the  MET  sta- 
tion report  is  keyed  to  the  ID  number.  Internally  defined  tables 
and  constants  are  detailed  in  the  program  listings  provided  as 
Part  IV  of  this  document . V . , 

; i - •;  ' ' ' 1 " : 

4.2.5. 5 Limitations . The  principle  limitation  of  the  MET  sta- 
tion report  generation  is  the  point  at  which  the  printout  occurs. 
The  complete  RAP  execution  cycle  must  be  finished  before  any  of 
the  report  is  output  to  the  line  printer. 

4.2.5. 6 CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 
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SECTION  5 

SCREWWORM  SURVIVAL  PROGRAM  (SSP) 


5.1  GENERAL  PROGRAM  CHARACTERISTICS 

The  Screwworm  Survival  Program  (or  Data  Base  Update  Sequence  No.  2) 
is  used  to  update  and  maintain  the  SEDS  data  base.  Each  days 
processing  uses  the  new  update  tape  generated  from  Data  Base 
Update  Sequence  No.  1 and  the  'previous  day's  data  base  tape. 

SSP  produces  a new  data  base  and  a screwworm  products  tape  (OWC) , 
which  is  suitable  for  film  processing.  The  screwworm  products 
are  optional  and  may  or  may  not  be  generated  daily.  SSP  consists 
of  three  major  components.  The  function  of  the  first  module, 

SSPDRV,  is  control,  including  user  initialization,  tape  I/O,  data 
base  calculation  sequencing,  output  image  sequencing,  and  program 
termination.  The  second  module,  ISCREW,  contains  the  data  base 
maintenance  algorithms  used  in  calculating  the  new  data  base.  The 
third  component,  SWPGEN*  generates  the  product,  eight  images  out- 
put to  the  OWC  tape.  In  addition,  the  processing  allows  one  of 
the  eight  images  to  be  monitored  via  the  SEDS  display.  The  basic 
configuration  of  SSP  is  described  by  figure  5-1. 

5.1. 1 Functional  Allocation.  As  defined  in  PHO-TN734,  Screwworm 
Eradication  Data  System  Functional  Requirements , dated  8 May  1974, 
SSP  performs  the  data  base  update  and  maintenance  processing.  Data 
base  computations  and  archive  processing  are  accomplished  through 
the  use  of  a four-to-one  compression  scheme,  using  every  fourth 
element  (pixel)  of  every  fourth  scan  line.  Five  categories,  called 
channels,  of  information  are  maintained  as  the  SEDS  data. base. 

The  information  is  stored  on  9- track,  800  bpi  magnetic  tapes.  The  . 
five  channels  of  data  are  short-term  mean  air  temperature  (STMAT) , 
long-term  mean  air  temperature  (LTMAT) , long-term  mean  crop  mois- 
ture index  (LTMCMI) , degree-day  sum  (DDSUM) , and  data  quality 
channel  (DQC).  Each  channel  represents  16-bit  calculations  or 
running  sums  for  each  pixel  over  the  last  N days,  where  N is  the 
data  base  length. 

5.1.2  Program  Flow  Chart.  See  figure  5-2. 
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Figure  5 - 2 SSP  Flow  Chart 
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5 1 3 Timing1  and  Sequencing.  SSP  is  designed  to  be  run  following 
Data  Base  Sequence  No.  1 (.RAP)  execution.  In  the  normal  days  pro- 
duction cycle:,  the  new  data  base  update  tape  from  RAP  is  one  of 
the  inputs  to  SSP.  Following  SEDS  initialization  of  SSP,  the  user 
is  [required  to  properly  configure  before  starting  SSP.  This  in- 
cludes such  items  as  mounting  the  correct  old  data  base  tape  a 
blank  tapes  on  designated  tape  drives  and  making  selected  VT05 
entries.  Once  initialisation  and  setup  is  complete,  program  exe- 
cution is  started  and  continues  for  about  30  minutes.  The  source 
data  is  the  new  data  base  update  tape  and  the  previous  dayb  data 
base  tape.  These  tapes  contain  similar  header  records  followed 
by  550  data  records*  each  of  which  contains  information  for  one 
scan  line.  A data  record  from  each  tape,  representing  the  same 
scan  line  and  pixels,  is  input  by  the  SSP  controlling  module, 
SSPDRV  The  data  is  read  into  memory  from  tape  and  passed  on  to 
the  data  base  calculations  module,  ISCREW.  Predefined  algorithms 
calculate  new  running  sums,  based  on  the  SSP  execution  mode,  old 
data  base,  and  update  tape  data.  After  a data  record  represent- 
ing one  scan  line  of  new  information  is  generated,  control  is  re- 
turned to  SSPDRV  for  the  writing  of  a single  record  on  the  new 
data  base  tape.  Optional  control  is  then  passed  on  to  the  product 
generator,  SWPGEN.  From  the  information  contained  m the  five 
channels  of  the  new  data  base,  eight  imagery  products  are  calcu- 
lated and  formatted  as  color  maps.  The  images  are  output  to  tape, 
with  one  of  them  being  viewed  on  the  SEDS  display  monitor.  Con- 
trol1 is  returned  to  SSPDRV,  which  inputs  the  next  data  records 
from  the  update  and  old  data  base  tapes.  This  sequence  continues 
for  550  cycles  until  termination. 

5.1.4  storage  Allocation.  The  storage  requirements  for  SSP  are 
illustrated  by  figure  5-3.  As  shown  by  the  diagram,  the  instruc- 
tion space  required  by  both  the  controlling  module,  SSPDRV,  and 
the  data  base  calculations  module,  ISCREW,  is  approximately  8K  o 
core  storage.  The iBK  buffer  ABUFF  is  used  fpr  update  and  data 
base  tape  input  and  output.  The  execution  space  of  the  product 
generation  module,  SWPGEN,  is  about  12K  of  core  storage.  The  *K 
buffer,  DBUFF,  is  used  as  the  products  calculations  transfer  bu 
fer  and  work  area  for  the  eight  generated  images. 
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Data  Base  Characteristics 

File  Description.  The  common  files  of  SSP  are  ABUFF  and  , 
DBUFF.  ABUFF  is  an  8K  storage  buffer  used  for  tape  input/ 
output  sequencing  between  SSPDRV  and  ISCREW.  The  format 
of  ABUFF  will  assume  the  data  record  formats  of  both  the 
update  and  data  base  tapes.  DBUFF  serves  as  a linking 
storage  area  between  ISCREW  and  SWPGEN.  The  format  of  each 
is  described  in  figure  5-4. 

Item  Description..  ISCREW's  processing  is  determined  by 
user  initialization  and  the  parameters  set  up  by  SSPDRV. 

Two1  factors  determine  a legal  processing  mode  of  SSP,  the 
active  channels  on  the  update  tape,  and  the  long-term 
averaging  period  (N)  specified  in  the  header  records  of 
both  input  tapes.  The  header  record  format  is  shown  in 
figure  5-5. 

Program  Constants.  The  following  seven  parameters  serve 
as  linkage  between  SSPDRV  and  ISCREW. 

• DELETE  - Delete  code  (1-4) 

• ADD  - Add  code  (1-6) 

• PRODCT  - Product  code  (1  = yes,  2 - no) 

» NOLD  - Old  data  base  length  (N) 

• NNEW  - New  data  base  length  (N) 

• CMIOF  - Old  CM I channel  on  update  tape  (NZ  = not  active) 

• CMINF  - New  CMI  channel  on  update  tape  (NZ  = not  active) 

The  values  of  program  constants  DELETE,  ADD,  NOLD  and  NNEW 
are  determined  by  table  5-1 . 
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PROGRAM  CONSTANTS  DELETE,  ADD,  NOLD  AND  NNEW 


SSP 

PROCESSING 

MODE 

UPDATE  TAPE  j 

CHANNELS  ACTIVE 

| 

DATA-- 

BASE 

LENGTH  (N) 

ADD 

DELETE 

CMI 

DMAT 

CMI 

DMAT 

NORMAL 

(ADD  AND  DELETE) 
ALL  DATA  PRESENT 

Q 

YES 

B 

; 

YES  ; 

1 

1 

. 

NNEW-NOLD 

r NORMAL 

(OLD  DATA  MISSING) 

B 

YES 

i 

? • 

NO 

NO 

2 

2 

! 

! j NNEWaNOLD 

ADD 

YES 

YES 

; NO 

NO 

3 

4 

NNEW=NOLD+l 

ZERO* 

(NEW  DATA  MISSING) 

, YES 

YES 

• I 

NOT  CHECKED 

4 

3 

NNEW-NOLD 

DELETE* 

B 

YES 

NOT  CHECKED 

5 

3 

NNEW-NOLD- 1 

INITIAL 

YES 

YES 

NO 

NO 

6 

4 

NNEW=1 

* UPDATE  TAPE  USED  IS  THE  DELETE -TAPE  USED  AS  INPUT  TO  RAP.  (NEW  CHANNELS 
BECOME  OLD) 

Jr  NOLD  * DATA  BASE  LENGTH  (N)  FROM  OLD  DATA  BASE  TAPE. 

1 NNEW  » DATA  BASE  LENGTH  (N)  OF  NEW  DATA  BASE  TAPE. 
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5.2  SSP  CPC  CHARACTERISTICS 


This  paragraph  contains  a detailed  technical  description  of  the 
CPC’s  identified  in  paragraph  5-1.  The  instruction  listings  con- 
tained herein,  by  inclusion  or  reference,  specify  the  exact  con- 
figuration of  SSP. 


5.2.1  SSPDRV.  SSPDRV  is  the  controlling  or  driving  component^of 
SSp.  Its  functions  have  been  previously  defined  in  paragraph  5.1. 
The  module  is  composed  of  several  separate  subcomponents.  One 
subroutine,  called  "SSPDRV,"  is  written  in  PDP-11  FORTRAN  and 
acts  as  the  driver  linking  SSP  with  the  SEDS  control.  The  other 
subcomponents  are  written  in  PDP-11/45  assembly  language.  They 
are  described  in  the  following  paragraphs. 


5.2. 1.1  Subcomponent  Descriptions 

A "SSPDRV".  This  subcomponent  of  the  component  SSPDRV  is 
* the  SSP"* driver  routine  of  SEDS.  "SSPDRV"  is  necessary 
. because  of  the  system  segmentation  and  overlay  software 
utilized  by  SEDS. 

B "SSP".  This  is  the  title  given  to  the  main  subcomponent 
' of  the  component  SSPDRV.  As  previously  stated,  user  con- 
trol and  processing  sequencing  are  the  primary  functions 
of  the  SSPDRV  component.  User  control  is  accomplished 
through  the  VT05B  alphanumeric  display  terminal,  consist- 
ing of  a CRT  display  and  self-contained  keyboard.  "SSP 
utilizes  special  SEDS  VT05  input/output  software.  VTLINK 
is  the  "SSP"  routine  called  directly  for  linkage  to  the 
VT05  VTLINK  is  discussed  elsewhere  in  this  document; 
however,  it  should  be  stated  that  VTLINK  allows  the  SSP  . 
VT05  display  to  be  initialized  and  sets  up  user -changeable 
input  fields.  The  SSP-initialized  VT05  display  is  shown 
in  figure  5-6.  Error  messages  and  operator  advisory  in- 
structions are  output  to  the  VT05.  Tape  input  and  output 
control  is  performed  through  interface  with  two  subrou- 
tines ST0C1  and  ST0C2 . "SSP"  makes  segmentation  and  core 
overlay  calls  to  bring  in  ISCREW  and  SWPGEN.  Program  ter- 
mination and  return  to  SEDS  residence  control  are  other 
functions  of  "SSP." 
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C.  ST0C1.  This  is  the  subcomponent  called  by  "SSP"  to  per- 
form  various  tape  input/output  functions  for  the  tape 
units  of  tape  controller  1. 

D.  ST0C2 . This  is  the  subcomponent  called  by  "SSP”  to  per-^ 
form  the  various  tape  functions  of  tape  controller  2.  The 
existing  Bucode  tape  drive  configuration  for  SEDS  is  shown 
in  figure  5-7.  The  calling  sequences  and  packet  format  are 
detailed  in  figure  5-8. 

E GNDATE.  This  is  a subroutine  that  converts  the  ASCII  date 
stored  in  the  SEDS -resident  locations  DAY,  MONTH,  and  YEAR 
to  binary. 

F.  DQCAL.  This  is  an  assembly  language  subroutine  that^  up- 
dates and  calculates  the  fifth  data  base  channel.  The 
channel  is  called  the  data  quality  channel  or  DQC,  and 
consists  of  two  8-bit  subchannels  per  16-bit  channel  word. 
The  two  subchannels  are  NGOOD  and  STQUAL.  NGOOD  is  the 
number  of  days  of  good  satellite  data  out  of  the  last  N 
days  of  data  for  each  pixel.  The  determination  of  NGOOD 
for  each  pixel  is  the  value  of  DQFLAG,  which  is  placed  in 
the  most  significant  byte  of  the  DMAT  channel  of  the  data 
base  update  tape.  Figure  5-9  details  the  logic  of  the 
NGOOD  subchannel  update.  The  second  subchannel  is  the 
short-term  mean  quality  value,  STQUAL. 


This  8-bit  value  is  stored  in  the  most  significant  byte 
of  the  DQC  word  for  each  pixel.  It  is  updated  from  the 
DQFLAG  of  the  new  DMAT  channel  on  the  data  base  update 


tape.  A new  parameter, 
follows . 

QVALUE , 

is  set  for  each  pixel  as 

DQFLAG 

QVALUE 

EXPLANATION 

0 

2 55 

All  data  ok 

128 

MET  data  only 

2 

192 

Satellite  data  only 

3 

0 

No  data 
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(ST0C1) 


(ST0C2) 


F.MT  140 

• INTERRUPT  VECTOR  - 224g 

• PRIORITY  - 226  (240) 


EMT  145 

• INTERRUPT  VECTOR  - 260 

• PRIORITY  - 262  (240) 


Figure  5-7  BUCODE  Tape  Drive  Configuration 
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CALL  TO  ST0C1  AND  ST0C2; 

JSR  R5,  @ # STOC1  OR  2 

BR  A 

.WORD  CNTRL  i TAPE  CONTROL 

.WORD  BUFADR  ; BUFFER  ADDRESS 


A: 

ia  i4  it  ti  it  io  a a 

*'i  • 

9 4 

1 I 1 

0 

CNTRL: 

TAPE 

UNIT 

I 1 

FUNC 

0 

+2 

SPARE 

+4 

: ' WORD  COUNT 

+6 

. 

r. 

✓ 

* 

• J 

J 

* > 

+34 

> 

immmm 

J 

BUFADR: 

BUFFER  ADDRESS 

♦FIRST  TIME  THRU 


15  WORDS 
FOR  HEADER 
RECORD 
CONTENTS 


FUNCTION  (BITS  1-3): 

001  = READ 

010  = WRITE 
111  = REWIND 

011  = WRITE  EOF 

TAPE  UNIT  (BITS  6,7): 
NO.  00  OR  01 


Figure  5-8  ST0C1  and  ST0C2  Calling  Sequences 
and  Packet  Format 
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Figure  5-9  NGOOD  Subchannel  Update  Logic 
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Using  the  STQUAL  value  from  the  old  data  base  tape,  the 
following  formula  is  used  to  calculate  the  new  STQUAL 
subchannel: 

STQUAL(new)  = [(0.44)*QVALUE+(0.56)STQUAL(OLD)+0.5] 

G.  SSPDKI . This  is  an  assembly  language  subroutine  called 
by  "SSP"  to  read  frojm  disk  the  six  screwworm  growth  con- 
stants used  in  calculating  the  combined  screwworm  product. 
The  product  is  output  as  the  fifth  product  on  the  OWC  tape. 
The  data  resides  in  the  file  AIKSWP.TBL  on  DKO  under  the 
user's  identification  code  (UIC)  200,200.  The  36-word  disk 
file  contents  is  in  ASCII  code  which  is  used  as  a default 
condition  of  the  SSP  VT05  display.  The  exact  format  and 
layout  of  the  file  is  specified  in  paragraph  5. 2.1.3. 

H.  SSPDKO.  This  is  an  assembly  language  subroutine  tailed 

by  "S5P"  to  write  back  to  disk  the  six  screwworm  constants. 
This  subroutine  is  the  write  counterpart  of  SSPDKI. 

I.  RETRY 1 . This  is  an  assembly  language  subroutine  called  by 
"SSP"  if  read  parity  errors  are  encountered  on  tape  con- 
troller No.  1 tape  drives.  The  configuration  of  SSP  dic- 
tates that  the  data  base  update  tape  be  input  from  device 
MTO,  When  read  parity  errors  are  detected  for  a given 
record,  10  attempts  are  made  to  read  the  record  error- free. 
If  all  are  unsuccessful,  a VT05  advisory  message  is  output, 
and  an  abort  condition  exists. 

J.  RETRY 2 . This  subroutine  is  identical  to  RETRY1  except  that 
it  processes  read  parity  errors  on  tape  controller  No.  2 
tape  drives.  The  old  data  base  tape  is  input  from  device 
MT3.  t 

K.  DQCMOV.  This  subroutine  transfers  625  16-bit  data  words 
from  DQCBUF  into  another  buffer  specified  by  R2 . 

L.  REFRSH.  This  subroutine  refreshes  the  initial  VT05  display 
for  SSP . J\ 

5.2.1. 2 Flow  Charts.  See  following  44  pages. 
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5. 2. 1.3  Interfaces 

A Input  Data.  The  input  data  to  SSPDRV  comes  from  three 

sources --"from  tape,  from  the  user  through  VT05,  and  from 
disk.  Tape  inputs  are  from  the  data  ba=e.“p^^e 
old  data  base  tapes.  The  data  is  stored  in  the  8K  buffer 
ABUFF,  in  the  format  shown  by  figure  5-4.  ^ser  inpu  s aT.T  , 
made  via  the  VT05  keyboard  into  changeable  fields.  The  AL1 
key  is  used  to  position  the  cursor  at  such  fields.  The  disk 
file  previously  mentioned  resides  on  the  system  disk  under  UIC 
200,200,  and  contains  the  current  screwworm  growth  constants . 
As  shown  in  figure  5-6,  six  parameters  are  required.  The 
36-word  file  is  described  by  figure  5-10,  and  is  composed 
of  signs,  integers,  and  fractions  from  entries  in  ASCII 

and  binary  notation. 

B Output  Data.  SSPDRV  outputs  data  from  the  tape  reads  to 
the  ISCREWmodule.  In  addition,  the  seven  control  param- 
eters calculated  are  passed  on  for  data  base  calculations, 
as  specified  in  paragraph  5.1.5,C.  Another  call  packet, 
defined  elsewhere,  is  set  up  for  the  SWPGEN  module.  New 
data  base  information  calculated  and  stored  in  ABUFF  is 
written  out  to  tape  via  SSPDRV. 

5. 2.1.4  Data  Organization.  The  primary  internally  defined  items 
of  SSPDRV  are  those  associated  with  the  VT05  changeable  fields. 

The  list,  shown  in  table  5-2,  describes  initialized  or  defaulted 
conditions.  The  unlisted  internal  symbols  in  SSPDRV  subroutines 
are  described  within  the  listings. 


S 2.1.5  Limitations.  Operational  restrictions  of  SSP  are_ the  • 
most  important  limitations.  The  configuration  setup,  as  shown  m 
figure  5-1,  is  definitive  in  that  specified  input  and  output  tapes 
must  be  mounted  on  designated  tape  drives.  Error  analysis  of  tape 
reads  and  writes  is  pertinent  to  the  FORTRAN  data  base  calcula- 
tions done  in  I SCREW.  A series  of  VT05  advisory  messages  are  out- 
put to  inform  the  user  of  existing  error  conditions.  Table  5-3 
is  a list  of  numbered  messages,  referenced  in  the  detailed  flow 

charts. 


TABLE  5-2 

SSPDRV  INTERNALLY  DEFINED  ITEMS 

...  . J . : - J 


NAME 

TYPE 

DEFAULT 

; 

LIMIT 

DESCRIPTION 

DBMODE 

ASCII 

N 

A,D,I,N,Z 

DATA  BASE  PROCESSING  MODE 

PDDMOD 

NUMERIC 

3 

0-3 

PRODUCT  GENERATION  MODE 

NDBLTH 

NUMERIC 

1-99 

NEW  DATA  BASE  LENGTH 

UPDNOC 

NUMERIC 

2 OR  4 

NO.  OF  CHANNELS  ACTIVE  ON  UPDATE  TAPE 

UPDLTH 

NUMERIC 

1-99 

UPDATE  TAPE  DATA  BASE  LENGTH 

ODBNOC 

NUMERIC 

5 

NO.  OF  CHANNELS  ON  OLD  DB  TAPE 

ODBLTH 

NUMERIC 

1-99 

OLD  DATA  BASE  LENGTH 

ORBIT 

NUMERIC 

0-32767 

ORBIT  NO.  OF  DATA 

DODATA 

NUMERIC 

MM-DD-YY 

DATE  OF  DATA  FROM  UPDATE  TAPE 

UPDTNO 

ASCII 

xxxxxx 

6 CHARS 

UPDATE  TAPE  NO. 

NDBTNO 

ASCII 

6 CHARS 

NEW  DATA  BASE  TAPE  NO.  (USER  INPUT) 

ASCII 

6 CHARS 

OWC  TAPE  NO.  (USER  INPUT) 

ODBTNO 

: ' v. 

ASCII 

xxxxxx 

6 CHARS 

OLD  DATA  BASE  TAPE  NO. 

! 

- ■MiitintmunuMMi  I i 
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TABLE  5-3 

VT05  ADVISORY  MESSAGES 


1 . 

NO. 

NAME 

MESSAGE 

6 

PROCMG 

ENTER  OUTPUT  TAPE  NBRS  & "GO" 

8 

DBUCMG 

DATA  BASE  UPDATE  COMPLETE*** 

10 

ABRTMG 

ABORT  CONDITION  - DO  NOT  PROCEED 

12 

ENTNK 

ENTER  NDBLTH=1  & "GO" 

14 

SWT ERR 

***OWC  PRODUCTS  TAPE  ERROR 

16 

SPRVT 

(BLANK  LINE)  ; 

18 

IUPIDM 

INVALID  UPDATE  TAPE  ID  ON  MTU  0 

20 

1 00 1 DM 

INVALID  OLD  DB  TAPE  ID  ON  MTU  2 

22 

VFMEM 

i VERIFY  MODE  ENTRY  & ENTER  "GO" 

24 

DPTOM  . 

DISPLAY  TIME-OUT  * ENTER  "CON" 

26 

TPERRO 

TAPE  READ  PARITY  ERROR  ON  MTU  0 

28 

TPERR2 

TAPE  READ  PARITY  ERROR  ON  MTU  2 

30 

TPERR1 

TAPE  WRITE  PARITY  ERROR  ON  MTU  1 

32 

DSKMAG 

RE- I NIT  S-W  GROWTH  CONSTANTS? 

34 

WRTM 

WRITE  RING  MISSING  ON  MT1 
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i . • 

5.2. 1,6  CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 

5.2.2  i SCREW 

5. 2. 2.1  Subcomponent  Description.  The  ’data  base  calculations 
component'of  SSP  is  ISCREW.  Its  functions  have  been  previously 
described  in  paragraph  5.1.  The  module  is  composed  primarily  of 
a single  FORTRAN  routine.  The  linking  parameters  from  SSPDRV  are 
set  as  shown  in  table  5 j- 1 . Update  tape  data  and  old  data  base 
tape  data  is  passed  in  ABUFF.  The  old  data  base  information  is 
replaced  by  the  new  data  base  calculations  in  ABUFF  on  the  return 
to  SSPDRV.  Product  generation  data  is  moved  into  DBUFF . The  data 
base  processing  mode  established  in  SSPDRV  sets  data  flow  paths 
for  data  base  maintenance.  Four  of  the  five  data  base  channels 
are  calculated  in  ISCREW,  as  follows. 

A.  STMAT . This  '.s  the  short-term  mean  air  temperature  chan- 
nel, or  channel  No.  1,  formed  from  the  spatially  registered 
daily  mean  air  temperature  (DMAT)  values  from  the  data  base 
update  tape.  Ideally,  this  channel  would  contain  the  arith 
metic  mean  of  the  last  four  days  DMAT  values  for  a given 
registered  pixel  location ; '-however , because  that  method 
requires  daily  access  to  three  historical  DMAT  channels 
from  the  data  base,  the  following  low-pass  digital  filter- 
ing procedure  is  used: 

STMATi  = STMAT  + K* (DMAT  ^ - STMAT i _ x ) 

Where: 


K = 0.44 


B.  LTMAT . Channel  No.  2 is  the  long-term  mean  air  temperature 
which  is  saved  in  the  data  base  as  16-bit  riinning  sums  for 
each  pixel  over  the  last  N days,  where  N is  the  long-term 
averaging  period.  The  normal  (N  constant)  daily  procedure 
is: 

LTMAT.  = LTMAT.  . + DMAT.  - DMAT.  vT 
l l-l  l i-N 
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When  N is  incremented  by  one,  the  calculation  is: 

LTMAT.  = LTMAT . _ + DMAT . 

1 l-l  l 

When  N is  decremented  by  one,  the  calculation  is: 

LTMAT . = LTMAT.  + DMAT.  - DMAT.  _t  - DMAT.  ... 
l l l l-N  i-N+1 

C.  LTMCMI . Channel  No.  3 is  the  long-term  mean  crop  moisture 
index,  a running  sum  of  N CMI  values.  The  normal  (N  con- 
stant) daily  update  procedure  is: 

LTMCMI . = LTMCMI  . . + CMI  . - CMI  . .. 
l l-l  l l-N 

When  N is  incremented  by  one,  the  calculation  is: 

LTMCMI.  = LTMCMI.  , + CMI . 

l l-l  i 

When  N is  decremented  by  one,  the  calculation  is: 

LTMCMI  . = LTMCMI  . . + CMI . - CMI ...  - CMI  . Xlj_ 
l l-l  l l-N  i-N+1 


D.  DDSUM.  Channel  No.  4 is  the  degree-day  sum  values  saved 
as  16-bit  running  sums  for  each  pixel.  The  normal  (N  con- 
stant) daily  update  procedure  is: 

DDSUM.  = DDSUM.  . + tT  - T"  m 
i l-l  l l-N 

Where : 


284  °K 
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When  N is  decremented  by  one,  the 

DDSUM ....  = DDSUM . , + 
l l-l 

When  N is  decremented  by  one,  the 
DDSUMi  = DDSUM ^ (updated) 


calculation  is: 

__  * 

T. 

1 

calculation  is: 
- T' 

i-N+1 


Where: 


T.  = DMAT . M.T 

i-N  + 1 l-N+l 

TT  - = T.  * r 2 84  °K 
i-N+1  i-N+1 


E.  DQC.  Channel  No.  5 is  the  data  quality  channel  discussed 
in  paragraph  5. 2. 1.1. 

5. 2 i 2 . 2 Flow  Charts.  See  the  following  18  pages. 


/ 


5-73 


JSC-10019 
Part  II 


JSC-10019 
Part  II 


JSC-10019 
Part  II 


5-76 


5-77 


JSC-10019 
Part  II 


^T\ 


JSC-10019 
Part  IX 


JSC-10019 
Part  II 


/*^/a r 

OfSoG  #ur, f &. 


JSC-10019 
Part  II 


St  6 


y iiPEODUCIBlLITY  OF  THE 
f*?EIOINAL  PAGE  IS  POORi 


5-84 


JSC-10019 
Part  II 


5. 2. 2. 3 Interfaces 

A.  Input  Data , The  input  data  to  ISCREW  comes  from  an  8K 
common  buffer  called  ABUFF.  The  physical  layout  of  this 
buffer  is  shown  by  figure  5-4.  As  previously  described, 
the  upper  4K  area  of  the  buffer  contains  one  record  from 
the  data  base  update  tape.  The  lower  4K  area  contains  one 
record  of  the  corresponding  scan  line  from  the  previous 
dayb  data  base  tape.  The  information  contained  in  these 
two  buffers  is  used  to  update  the  SEDS  data  base  and  cal- 
culate pixel  values  for  the  current  day's  OWC  tape  images. 

B.  Output  Data.  The  new  data  base  values  for  one  scan  line 
are  put  into  the  lower  4K  area  of  ABUFF.  The  OWC  images 
are  calculated  and  in  the  4K  common  buffer  called  DBUFF. 
This  data  is  subsequently  picked  up  and  used  by  SWPGEN  for 
product  generation. 

5. 2. 2.4  Data  Organization.  The  principle  internal  data  organi- 
zation of  ISCREW  consists  of  fixed  constants  and  intermediate 
buffers  used  in  the  regeneration  of  the  data  base,  pixel  by  pixel, 
within  each  scan  line. 

5. 2.2. 5 Limitations . The  major  limitation  of  ISCREW  is  time. 

Due  to  the  complexity  of  some  of  the  data  base  channel  calcula- 
tions, this  program  was  written  in  FORTRAN,  which  inherently 
runs  longer  than  pure  machine  language  code. 

5. 2. 2. 6 CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 

5.2.3  SWPGEN.  The  product  generation  component  of  SSP  is  SWPGEN. 
Its  major  functions  have  been  previously  discussed  in  paragraph 
5.1.  The  module  is  composed  of  several  separate  subcomponents; 
all  subroutines  are  written  in  PDP-11/45  assembly  language. 

5. 2, 3.1  Subcomponent , Descriptions 

A.  PDGEN . The  main  subcomponent  of  SWPGEN  is  PDGEN.  It  and 
SWPGEN' s other  subcomponents  comprise  the  product  genera- 
tion capability  of  SEDS.  Through  the  calling  sequence  to 
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PD.GEN  and  supporting  subroutines,  the  isothermal,  RAP,  DPG, 
and  SSP  products  are  calculated,  formatted,  color  coded, 
and  output  to  tape  and/or  display.  The  calling  packet  to 
PDGEN  may  be  placed  in  the  user's  designated  area,  or  it 
may  be  placed  in  specified  memory  locations  in  a SEDS  com- 
mon area  named  SCOMVT.  Figures  5-11  and  5-12  illustrate 
the  two  methods.  Additional  user  control  through  the  VT05 
is  available  during  initialization  for  entering  items  such 
as  tape  number  and  comments.  Once  program  execution  has 
started,  input  control  through  the  VT05  is  lost  except  for 
pauses  and  aborts.  A current  scan  line  indicator  updates 
as  each  line  of  data  is  processed.  The  product  generation 
VT05  display  for  Data. Base  Sequence  No.  2 (OWC)  products 
is  shown  in  figure  5-13. 

OWCPRO.  This  subroutine  is  called  to  calculate,  format, 
and  color-assign  the  eight  OWC  images  of  SSP.  The  input 
is  passed  in  the  data  buffer  DBUFF  as  shown  by  figure  5-4. 
The  first  four  images  in  DBUFF  are  reduced  from  16-bit  to 
8-bit  values.  This  conversion  is  made  through  256-place 
empirical  function  tables  for  growth  potential  equivalents. 
The  fifth  product  is  a combination  of  the  first  four  images 
The  screwworm  growth  constants  displayed  on  the  initial  SSP 
VT05  screen  are  used  in  this  calculation: 

S5  ’ 7T  * Vl  + A2S2  + AJS3  * A4S4 

Where: 

51  = Growth  potential  from  STMAT  empirical  table 

52  - Growth  potential  from  LTMAT  empirical  table 

S_  = Growth  potential  from  LTCMI  empirical  table 

* Growth  potential  from  DDSUM  empirical  table 

S_  = Combined  growth  potential 

A^  = Coefficients  input  via  VT05,  where  1 s A-p  £ + 1 
C = Coefficient  input  via  VT05,  where  0 < C £ 200 
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NORMAL  CALL  TO  PDGEN: 


CMDWD: 

+2 

+4 

+6 

+8 


JSR  R5,@#PDGEN 

BR  A 

.WORD  CMDWD 

.WORD  DATADR 

A: 


STATUS 

IMAGE  PkODUrt  0/l> 
SIZE'  CODE  CODE 

TAPE  UNIT  NO.  (0-3) 

2 

1 

4 

3 

6 

» » » i — i—i — i — 

5 

_j — i — iii»  ■«— 

* IF  SET  = FIRST  TIME  THRU 


6-CHAR 
TAPE  NO. 
IN  ASCII 


DATADR: 


it  M is  <t  n «o  » • 7 * 9 , 4 , l , 1 ■ ' (- 

■ i ii  i i n — i — r— r~T—i  • ' r 

INPUT  DATA  ADDRESS 


OUTPUT  CODE  (BITS  0,1): 

00  = NONE 

01  * DISPLAY 

10  = TAPE  ONLY 

11  = BOTH 

PRODUCT  CODE  (BITS  2-5): 

1000  = ISO  DAY  (OID) 

1001  = ISO  NIGHT  (OIN) 

1010  = CMI  , x 

1011  = RAINFALL  (ORC) 

1100  “ SCREWWORM  (OWC) 

1101  * SPECIAL 


IMAGE  SIZE  (BITS  6-7): 


00  = COMPRESSED  (625  PIXELS,  550  SCAN  LINES 

01  = NORMAL  (2500  PIXELS,  2200  SCAN  LINES) 


STATUS  (UTS  12-15): 

12  - IF  SET,  DISPLAY  TIME  OUT 

13  - IF  SET,  MANUAL  ABORT 

14  - IF  SET,  OPERATION  COMPLETE 

15  - IF  SET,  INVALID  TAPE  WRITE 


Figure  5-11  Normal  PDGEN  Calling  Sequence 
and  Packet  Format 
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Q 

CALL  TO  PDGEN: 


.CSECT 

SCOMVT 

!blkw 

198. 

PDGCMD: 

. BLKW 

5 ; CONTROL  PACKET 

PDGBUF: 

.BLKW 

1 ; INPUT  BUFFER  ADDRESS 

ORBIT: 

.BLKW 

1 ; ORBIT  NUMBER 

DODATA: 

.BLKW 

3 ; DATE-OF-DATA 

.*CSECT 

PDGBUF : 

ORBIT: 

DODATA: 

+2 

+4 


DATE  OF 

DATA 

(BINARY) 


Figure  5-12  Alternate  PDGEN  Call  Packet  in  Resident 
Common  Area  SCOMVT 
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Figure  5-13  PDGEN  VTO 5 Display  (OWC) 
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OWC  products  1-5  use  the  same  256-place  table  (FCNLS1)  for 
color  indexing.  Eleven  colors  are  used  to  represent  growth 
potential  measurements  between  0.3  and  3.7  in  increments 
of  0.3.  The  sixth  image  of  SSP  is  the  DMAT  from  the  data 
base  update  tape.  A 256-place  table,  DMFCT,  containing 
28  distinct  colors  represents  temperatures  from  -3  °C  to 
40  °C . The  seventh  and  eighth  images  are  from  the  fifth 
data  base  channel.  These  are  NGOOD  and  STQUAL,  discussed 
previously.  The  NGOOD  image  is  color  indexed  from  a 15- 
place  table  (FCTNGD)  representing  from  1 to  15  days  of 
good  satellite  data.  The  STQUAL  image  uses  another  256- 
place  table,  STQFCT , containing  34  colors. 

FCGEN.  This  subroutine  is  called  by  PDGEN  to  do  the  final 
color  coding  and  data  formatting  prior  to  tape  and/or  dis- 
play output.  The  6-bit  color  index  is  translated  via  a 
64-place  table,  FCTCVT.  At  scan  line  number  492,  the  pro- 
duct annotation  subroutine,  OPNOT,  is  called  to  overlay 
the  lower  part  of  the  images  with  appropriate  alphabetic 
and  numeric  annotation  for  subsequent  product  identifica- 
tion. The  call  packet  to  FCGEN  set  up  by  PDGEN  is  detailed 
in  figure  5-14.  The  three-word  packet  is  set  up  internally, 
based  upon  the  call  to  PDGEN  and  VT05  inputs.  The  number 
of  bytes  to  be  processed  for  each  scan  line  is  2500  for  a 
normal-sized  image,  or  625  for  a compressed  image. 

U9WRT.  U9WRT  is  the  tape  formatter  and  tape  write  sub- 
routine called  by  FCGEN.  The  subroutine  inputs,  formats, 
and  outputs  data  to  tape  in  the  Imagery  Data  Universal 
Format  --  9-track,  800  bpi,  odd  parity  CCT.  As  implied 
by  its  name,  this  format  can  assume  many  arrangements. 
Basically,  it  consists  of  a header  record  which  defines 
the  format  of  the  following  identical  tape  records. 

Appendix  A explains  the  universal  format  in  more  detail. 
U9WRT  provides  a generalized  capability  to  write  tapes 
which  are  compatible  to  the  Production  Film  Converter  (PFC) 
for  image  processing.  The  set  of  control  arguments  required 
to  build  the  header  record  and  set  up  an  algorithm  to  set 
the  pattern  of  the  physical  tape  is  shown  in  figure  5-15. 

The  multiword  call  packet  should  be  set  up  on  the  initial 
interface  with  U9WRT,  and  each  successive  call  should  be 
made  for  every  channel  within  each  scan  line. 
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CALL  TO  FCGEN; 


MOV  #P ACKET.RO  ; PACKET  ADR 
JSR  PC,@#FCGEN  ; CALL 


PACKET 


1* 

** 

14  i J 

' 1 l'~" 

0/P 

CODE 

ii  i * 

X 

19  V > 

1 ~ T — 

TAPE 
UNIT  # 

STA- 

TUS 

1 

★ 

V NO.  OF 
/\  IMAGES 

NO.  OF  BYTES 

INPUT  BUFFER  ADDRESS 

♦ALSO  STATUS  BIT  (SEE  BELOW) 
**SET  IF  FIRST  TIME  THRU 


STATUS  (BITS  4,  6.  7): 

4 - SET  IF  DISPLAY  T/0 

6 - SET  IF  COMPLETE 

7 - SET  IF  TAPE  ERROR 


OUTPUT  CODE  (BITS  13,  14): 

00  = NONE 

01  = DISPLAY 

10  * TAPE 

11  = BOTH 


Figure  5-14  FCGEN  Calling  Sequence 
and  Packet  Format 
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CALL  TO  U9WRT : 

JSR  R5,@#U9WRT 

BR  A 

.WORD  PACKET 

.WORD  DATADR 


♦IF  SET,  NO  BYTE  REORDERING 
**IF  SET,  WRITE  HEADER  RECORD 


STATUS  (BIIS.6  J.1: 

6 - SET  IF  WRITE  COMPLE.E 

7 - SET  IF  TAPE  ERROR 


!•  II  II  II  1110  I I 7 • t 4 3 3 10 


CHADR: 

+2 

+4 


DATADR: 


MAX 

OF 

10 

CHANNELS 


Figure  5-15  U9WRT  Callin  ; Sequence 
and  Packet  Format 
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DISPL.  This  routine  is  called  by  FCGEN  when  the  option 
t5~oUtput  one  of  the  image  products  to  the  SEDS  display 
is  selected.  DISPL  interfaces  with  the  display  output 
handler  through  an  EMT  call  sequence  in  SEDS.  The  image 
data  is  output  to  tape  first,  and  then  to  the  display.  For 
a normal  image,  2500  pixels  by  2200  scan  lines,  the  size 
is  compressed  by  four  in  both  X and  Y directions  to  pre 
serve  the  aspect  ratio.  The  compressed  image  size  is  625 
pixels  by  550  scan  lines.  The  display  screen  is  576  x 420, 
so  most  of  a compressed  image  may  be  viewed  on  the  display 
at  one  time.  The  call  packet  to  DISPL  is  internally  set 
up  by  FCGEN  and  is  shown  by  figure  5-16.  The  third  param- 
eter of  the  call  sequence  to  DISPL  is  the  manual  interrupt 
packet.  This  feature  is  used  during  the  ground  control 
point  location  phase  to  determine  the  manual  interrupt 
number  entered  when  the  display  cursor  is  located  at  a 
given  X-Y  position.  The  day,  night,  or  annotation  data 
code  sent  to  DISPL  determines  the  scroll  direction  (top  to 
bottom  or  bottom  to  top)  and  scan  direction  (right  to  left 
or  left  to  right)  of  the  video  data  as  it  appears  on  the 
display  screen.  The  screen  is  cleared  and  the  display 
memory  is  reset  when  bit  7 is  set  for  "first  time  through. 
Bit  6 does  not  clear  the  screen,  but  outputs  five  blank 
lines  to  the  display.  In  normal  display  output,  the  data 
shift  defaults  to  two  and  the  six  LSB’s  of  each  byte  of 
data  will  be  displayed  in  black  and  white.  The  data  shift 
counter  effects  a left  shift  on  the  eight  bits  of  data. 

If  a data  shift  of  0 is  selected,  the  six  MSB’s  of  each 
byte  will  be  displayed.  Bit  11  selects  the  packed  mode 
for  color  assigned  data,  which  is  the  format  of  the  SEDS 
image  products.  The  6-bit  color  assignments  are  as  fol- 
lows: 


7654  3 210 


0 

E 

G 

G 

B 

0 

IE 

E 

Due  to  the  frequent  output  of  data  to  the  display,  random 
interrupts  sometimes  may  not  get  serviced.  When  this  hap- 
pens, bit  15  will  be  set  to  indicate  it.  The  situation  is 
of  little  consequence,  since  the  data  is  not  lost  to  the 
tape  or  to  the  display. 
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CALL  TO  DISPL: 

JSR  R5,@#DISPL 
BR  A 

.WORD  COMMAND  ; INPUT  COMMAND 

.WORD  DATADR  ; DATA  ADDRESS 

.WORD  INPAK  ; MANUAL  INTERRUPT  PACKET 


★SET  IF  DISPLAY  TIMEOUT 
**SET  IF  BYPASS  INTERRUPT  COMPLETE 
***SET  IF  PRODUCT  IMAGE 

tSET  IF  FIRST  TIME  THRU 
ttSET  IF  RESTART 
tttSET  IF  INTERRUPT 


DATA  TYPE  (BITS  0-1 


00  = DAY 

01  « NIGHT 

10  = ANNOTATION 


Figure  5-16  DISPL  Calling  Sequence 
and  Packet  Format 
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F.  OPNOT,  This  routine  is  called  by  FCGEN  to  initiate  the 
output  of  the  image  product  identification  feature.  Pro- 
duct annotation  for  compressed  images  starts  at  scan  line 
492,  and  for  normal- sized  images  at  scan  line  1968.  The 
annotation  format  varies  somewhat  for  each  image;  generally, 
it  has  four  character  lines.  The  first  contains  the  image 
name,  data  of  data,  and  orbit  number;  the  second  contains 
a color  bar  scale  of  the  colors  represented  in  the  image; 
the  third  contains  an  explanation  of  the  color  shades  be- 
neath the  color  bar;  and  the  fourth  contains  the  production 
date  and  an  optional  real-time  comment  about  the  image, 
entered  via  VT05  prior  to  program  execution.  Table  5-4 
illustrates  the  various  image  products  output  by  SEDS  which 
require  alphanumeric  and  color  bar  annotation.  The  images 
on  the  ORC  and  OWC  tapes  are  formatted  into  multichannel, 
compressed  scan  lines.  Figures  5-17  thru  5-19  identify  the 
specific  annotation  layouts  for  the  15  SEDS  image  products. 
The  alphanumeric  character  annotation  uses  the  first  616 
pixels  of  each  scan  line  across  the  compressed  image. 

There  are  two  character  sizes,  No.  1 and  No.  2.  No.  1 re- 
sides in  a 9 x 7 matrix,  occupying  nine  scan  lines  in 

height  and  seven  pixels  in  width.  Character  size  No.  2 

requires  an  18  * 14  matrix.  Using  character  size  No.  2 as 

the  basis,  44  character  positions  (44  x 14  s 616)  account 
for  the  width  of  the  annotation.  The  size  of  the  individ- 
ual color  squares  in  the  color  bar  scale  are  set  so  that 
correct  spacing  of  character  size  No,  1 annotation  is 
achieved.  The  color  content  in  the  various  color  bar  scales 
will  be  discussed  elsewhere  in  this  document.  The  numbers 
shown  for  each  color  square  reflect  only  a sequential  count 
of  the  number  of  distinct  colors  present.  The  three  anno- 
tation lines  and  color  bar  scale  require  54  scan  lines  on 
the  compressed  images. 

G.  ANNOT.  This  routine  is- called  by  the  subroutine  OPNOT  to 
perform  the  dot  matrix  character  generation  of  the  annota- 
tion feature.  In  general,  the  call  to  ANNOT  consists  of 
three  items  of  information,  the  address  of  an  input  char- 
acter string,  the  address  of  the  output  buffer,  and  the 
address  of  a control  word.  The  input  character  string 
must  contain  ASCII  characters  terminated  by  a code  of  133s. 
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TABLE  5-4 

SEDS  IMAGE  PRODUCTS 


SEDS 

PROGRAM 

TAPE 

ID 

IMAGE 

NAME 

■ 

• 

DESCRIPTION 

SRE 

(REGISTRATION) 

OID 

OIN 

ISO  DAY 
ISO  NIGHT 

TEMP  CODED  DAY  IR  CHAN  :(NORMAL  OR  COMP) 
TEMP  CODED  NIGHT  IR  CHAN  (NORMAL  OR  COMP) 

RAP 

(DATA  BASE  SEQ  NO.  1) 

ORC 

■ 

1)  R/F 

2)  TGT 

3)  AT 

4)  TMET  (ID) 

5)  QUAL 

COLOR  CODED  CLOUD  DETENTION  IMAGE 

COLOR  CODED  ESTIMATED  GROUND  TRUTH  TEMP 

COLOR  CODED  CURRENT  TEMP  DIFFERENCE  BETWEEN 
ACTUAL  AND  ESTIMATED  VALUES 

COLOR  CODED  DMAT  VALUES  OF  MET  STATION  REPORTS 
VIA  CARD  INPUTS 

COLOR  CODED  SOURCE  MAP  OF  TEMP  DATA 

SSP 

(DATA  BASE  SEQ  NO.  2) 

ONC 

1)  STMAT 

2)  LTMAT 

3)  LTCMI 

4)  DDSUM 

5)  S/W 

6)  DMAT 

7)  NGOOD 

8)  STQUAL 

SHORT-TERM  GROWTH  POTENTIAL  BASED  ON  DMAT 

LONG-TERM  GROWTH  POTENTIAL  BASED  ON  DMAT 

GROWTH  POTENTIAL  BASED  ON  LONG-TERM  CMI 

GROWTH  POTENTIAL  BASED  ON  DEGREE  DAY  SUM 

COMBINED  GROWTH  POTENTIAL  MAP 

COLOR  CODED  TEMP  MAP  OF  DAILY  MEAN  AIR  TEMP 

COLOR  CODED  MAP  OF  NO.  OF  OAYS  OF  SATELLITE 
DATA  IN  DATA  BASE 

COLOR  CODED  MAP  OF  SHORT-TERM  MEAN  QUALITY  OF  DATA 
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Figure  5-17  OID/OIN  Isothermal  Image  Annotation 
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PRODUCTION 
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Figure  5-19  OWC  - SSP  Image  Annotation 
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The  call  packet  to  ANNOT  is  internally  set  up  by  OPNOT  and 
is  shown  by  figure  5-20.  Figure  5-21  illustrates  the  com- 
position of  the  legal  annotation  characters  as  they  are 
formed  in  a 5 * 7 dot  matrix.  To  ensure  that  proper  spacing 
and  bordering  is  achieved,  the  characters  reside  in  a 7 x 9 
cross-section  rectangle  within  the  character  line. 

5. 2. 3. 2 Flow  Charts.  See  105  pages  following  figures  5-20  and 
5-21. 


s-ioi  _ --  -- 


JSC-10019 
Part  II 


JSR  R5,@#ANN0T 

BR  A 

.WORD  INBUF 
.WORD  OUTBUF 
.WORD  CNTRL 


; INPUT  STRING  ADR 
; OUTPUT  BUF  ADR 
; CONTROL  WORD 


A: 


J4  1 3 tt  II  l< 


7 t » 4 


tj  * CHARACTER  SIZE  **  CHARACTER  POSITION 

♦SCROLL  DIRECTION  (0  = TOP  TO  BOTTOM,  1 = BOTTOM  TO  TOP) 
♦♦SET  IF  PRODUCT  ANNOTATION 


Figure  5-20  ANNOT  Calling  Sequence 
and  Packet  Format 
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5. 2. 3. 3 Interfaces.  SWPGEN  is  a set  of  product  generation  sub- 
routines  for  SSPT  A similar  module  containing  the  same  subrou- 
tines  exists  in  the  registration  program  (ISOMOD)  to  build  the 
isothermal  products  OID  and  OIN.  The  Data  Base  Sequence  No.  1 
(RAP)  module  which  outputs  the  ORC  products  is  called  RFTGEN . 

The  basic  interface  of  the  various  product  generation  subroutines 
Is  shown  by  figure  5-22.  One  call  to  the  product  generation  mod,, 
ule  is  made  for  each  scan  line.  The  buffering  is  set  up  so  that 
all  five  images  for  the  ORC  products,  and  the  data  for  generating 
all  eight  images  of  the  OWC  products,  is  available  for  each  scan 
line.  The  data- input  to  the  product  generator  module  (PDGEN)  is 
first  converted  to  a 6-bit  color  index  code  and  then  to  the  2.2.2 
color  format  for  output  to  tape  and  display.  The  tape  formats  of 
the  ISO.  ORC,  and  OWC  products  are  illustrated  by  figures 
-thru  5-25,  respectively.  The  isothermal  tape  formats  ar<*  oc 
in  two  different  ways.  The  normal- sized  image  requires  one  record 
per  scan  line  totaling  2200  physical  records.  The  compressed 
image  is  blocked  four  scan  lines  per  record  for  138  records.  The 
ORC  and  OWC  tape  formats  require  two  records  per  scan  line  to^ 

1100  records.  All  tapes  are  terminated  by  three  end-of-file  marks 

The  false  color  tables  and  growth  potential  tables  used  by  FCGEN 
and  OWCPRO  are  256-place  tables  containing  the  6-bit  intermediate 
color  index  code.;  The  index  code  is  used  to  get  the  final  color- 
formatted  8-bit  value  (RRGGBBXX)  output  to  the  tape  and  the  dis- 
play. Only  OWC  images  1-4  require  the  special  additional  indexing 
into  the  growth  potential  tables  before  conversion  to  the  6-b.it 
color  index.  Three  growth  potential  or  empi^c&l  function  set 
tables  are  used  --  STLT,  for  the  STMAT  and  LTMAT  images;  CMI . for 
the  LTCMI  image;  and  MPT,  for  the  DDSUM  image.  The  fifth  OWC 
image  is  a composite  of' the  first  four  and  does  not  ha^®  a sepa" 
rate  growth  potential  table.  However,  the  first  five  OWC  images 
use  the  same  256-place  color  index  table  called  FCNLS1.  Eleven 
separate  colors  are  contained  in  this  table  to  color  code  growth 
potentials  of  0.3  to  3.7,  as  shown  in  the  color  bar  of  figure 

5- 19.  The  initial  data  values  (0-255)  for  each  image  serve. 

as  direct  indices  into  one  of  the  three  growth  potential  tables 
to  get  empirical  function  values  (0-255).  The  data  value- 
to -empirical  function  value  conversion  is  shown  in  tables  b-b 
through  5-7.  Conversion  from  empirical  funct ion  set values  to  a 

6 - bit  color  code  index  is  shown  in  table  5-8  (FCNLS1)  . The  tin 
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Figure  5-22  Interfaces  of  Product 
Generation  Subroutines 
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TABLE  5-6 

LTCMI  DATA  TO  EMPIRICAL  FUNCTION  VALUE  CONVERSION  (CMI) 
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TABLE  5-8 

EMPIRICAL  FUNCTION  TO  COLOR  CODE  INDEX  VALUE  CONVERSION  (FCNLS1) 


:mp.  func 

COLOR  INDEX 
(OCTAL) 

COLOR  b; 

0-17  / 

61 

1 

18-88 

< 65 

I 2 

89-128 

21 

3 

129-157 

05 

4 

158-179 

03 

5 

180-197 

57 

6 

198-213 

16 

7 

214-226 

15 

8 

227-238 

04 

9 

239-248 

10 

10 

249-255 

14 

11 

( 
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colot  conversion  for  all  products  occurs  by  using  the  64-place 
table  FCTCVT  (see  table  5-9)  to  get  the  8-bit  color  formatted 
value  for  output  to  tape  and  display. 

The  sixth  image  product  of  the  OWC  tape  (DMAT)  and  the  ORC  pro- 
ducts No.  2 and  No.  4 (TGT  and  TMET)  use  the  same  256-place  color 
index  table,  DMFCT , as  shown  in  table  5-10.  FTCNGD  1S  *he  c°l°r 
conversion  table  used  by  the  seventh  OWC  image  (see  table  5-11J. 

The  eighth  OWC  image  is  color-coded  according  to  STQFCT  (see  table 
5-12) . ORC  product  image  No.  3 is  DELTA  T and  uses  color  conver- 
sion table  DLTFCT , as  shown  in  table  5-13.  ORC  product  images 
No.  1 and  No.  5 (RAINFALL  and  QUAL)  are  color-coded  according  to 
the  color  bars  shown  in  figure  5-18.  The  color  index  code  is 
entered  at  the  time  of  product  calculation. 

The  two  isothermal  images  OID  and  OIN  use  two  separate  256-place 
color  index  tables,  as  shown  in  tables  5-14  and  5-15,  respectively, 


5. 2. 3.4  Data  Organization.  The  principal  internally  defined 
items  of  the  product  generator  module  are  those  associated  with 
the  VT05  display  (see  figure  5-13  for  layout).  A list  of  VT05 
variable  fields  with  initialized  conditions  is  shown  for  the  OWC 
products  in  table  5-16.  The  annotation  characters  output  on  the 
lower  portion  of  the  SEDS  images  (see  figure  5-21)  use  a dot 
matrix  table  called  DMTB.  The  characters  are  built  in  ANNOT  from 
the  input  ASCII  character  string,  which  is  specified  as  one  of 
the  three  parameters  in  the  call  packet.  DMTB  is  indexed  using 
a 6-bit  truncated  ASCII  value.  The  ASCII  characters  in  the  table 
are  in  groups  of  three,  with  each  group  requiring  seven  words. 

An  internal  counter  keeps  track  of  which  line  is  being  generated 
for  a given  character.  In  the  binary  expansion  of  the  octal  words 
black  is  stored  for  a zero  and  white  is  stored  for  a one.  Scroll 
direction  on  the  screen  (i. e. , top  to  bottom  or  bottom  to  top) 
determines  whether  or  not  word  1 or  word  7 of  the  three-character 
group  is  picked  up  first.  Table  5-17  details  the  contents  of  the 
octal  words  in  DMTB,  and  figure  5-26  shows  the  binary  expansion 
of  a threie- character  group  and  the  algorithm  to  generate  the 
characters.  DMTB  contains  154  entries  or  22  three-character 
groups,  with  each  group  containing  seven  words  (7  * 22  - 154). 
Each  group  of  three  characters  is  numbered  from  0 to  21.  To 
locate  a given  character's  5 x 7 dot  matrix  equivalence,  first 
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COLOR  INDEX 
(OCTAL) 


TABLE  5-9 

FINAL  COLOR  CONVERSION  (FCTCVT) 


, COLOR  BYTE 
(OCTAL) 


BINARY 


1 1 
0 0 


COLOR 

DESCRIPTION 

BLACK 
DARK  GREEN 
MED  GREEN 
GREEN 
DARK  RED 
DARK  YELLOW 


1 V 


200 

220 

240 

260 

300 

320 

340 

360 

004 

024 

044 

064 

104 

124 

144 

164 

204 

224 

244 

264 

304 

324 


1 1 
1 1 
1 1 
1 1 


1 1 
1 1 


1 1 


1 1 


1 1 


1 1 
0 0 
0 1 
1 0 
1 1 
0 o 
0 1 


o 1 

0 1 


MED  RED 


MED  YELLOW 


YELLOW 
DARK  BLUE 
DARK  CYAN 


DARK  MAGENTA 
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• 

TABLE  5-1 

3 (CONT'D) 

' 

COLOR  INDEX 
(OCTAL) 

COLOR  BYTE  1 

BINARY 

COLOR 

DESCRIPTION 

(OCTAL) 

H 

R 

G 

G 

B 

B 

0 

0 

36 

344 

B 

n 

HI 

ni 

1 

0 

0 

37 

364 

a 

1 

1 

1 

n 

1 

0 

0 

40 

010 

0 

0 

0 

1 

0 

0 

0 

MED  BLUE 

1 

f 

41 

030 

0 

m 

1 

1 

1 

0 

0 

0 

42 

050 

0 

0 

H 

a 

1 

0 

0 

0 

MED  CYAN 

i 

1 

43 

070 

0 

0 

l 

l 

1 

0 

0 

0 

' i 

44 

no 

0 

1 

0 

m 

1 

0 

0 

0 

45 

130 

0 

1 

0 

l 

1 

0 

a 

0 

i 

1 . 

46 

150 

0 

1 

i 

1 

0 

B 

0 

. ■ 

i 

47 

170 

0 

1 

i 

v 

1 

0. 

0 

• 

' ! 

! • 

50 

210 

1 

0 

0 

1 

0 

si 

0 

MED  MAGENTA 

I 

51 

230 

1 

0 

a 

i 

1 

0 

0 

0 

52 

250 

1 

0 

i 

0 

1 

0 

0 

0 

MED  GREY 

53 

270 

1 

0 

i 

l 

1 

0 

0 

0 

| 

54 

310 

1 

1 

0 

0 

1 

0 

0 

0 

55 

330 

1 

1 

0 

1 

1 

0 

0 

0 

• 

56 

350 

1 

1 

1 

0 

1 

0 

0 

0 

57 

370 

1 

1 

1 

1 

1 

0 

0 

0 

60 

014 

0 

0 

0 

0 

1 

1 

0 

0 

BLUE 

61 

034 

0 

0 

0 

1 

1 

1 

0 

0 

62 

054 

0 

0 

1 

0 

1 

1 

o 

0 

63 

074  | j. 

0 

0 

1 

1 

1 

1 

0 

0 

CYAN 

■ 

64 

114 

0 

1 

0 

0 

1 

1 

0 

0 

... 

' 

65  ! 

134 

0 

1 

0 

1 

1 

1 

0 

0 

66 

154 

0 

1 

1 

0 

1 

1 

0 

0 

! : 
■ 

67 

174 

0 

1 

1 

1 

1 

1 

0 

0 

70 

214 

1 

0 

0 

0 

1 

1 

0 

0 

71 

234 

1 

0 

0 

1 

1 

1 

0 

0 

72 

254 

1 

0 

1 

0 

1 

1 

0 

0 

. L 

73 

274 

1 

0 

1 

1 

1 

1 

0 

0 
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TABLE  5-10 

dmat,  tgt,  and  tmet*  color  CONVERSION  (DMFCT) 


DATA 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO. 

DATA 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO. 

0-40 

00 

1 

141-144 

41 

15 

j 41-52 

04 

2 

145-148 

21 

16 

53-64 

r io 

3 

149-152 

23 

17 

! 65.-76 

\ 14 

4 

153-156 

03 

18 

77-88 

34 

5 

157-160 

02 

19 

89-100 

74 

6 

161-164 

01 

20 

101-112 

64 

7 

165-168 

07 

21 

113-116 

24 

8 

169-172 

13 

22 

! 117-120 

20 

9 

173-180 

17 

23 

121-124 

40 

10 

181-188 

15 

24 

125-128 

60 

11 

189-196 

11 

25 

129-132 

62 

12 

197-204 

25 

' 26 

133-136 

63 

13 

205-212 

52 

27 

137-140 

67 

14 

213-255 

77 

28 

*DMAT  - owe  PRODUCT  NO.  6 
TGT  - ORC  PRODUCT  No.  2 
TMET  - ORC  PRODUCT  No.  4 
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TABLE  5-11 

NGOOD*  COLOR  CONVERSION  (FCTNGD) 


NO. .OF  DAYS 
(DATA) 

COLOR  INDEX  (OCTAL) 

COLOR  BAR  NO. 

0 

1 1 1 1 

00  1 

1 

, 14  ! 

1 

2 

74  i 

2 

3 

24  j 

3 

4 

*'  60  j 

4 

5 

| 67 

5 

6 

23  .1 

6 

7 

1 03  ; 

7 

8 

i ' oi  . j 

8 

9 

07 

' 9 

10 

i.  ” : 

10 

11 

! 15  ! 

n 

12 

]-  11  1 

12 

13 

25  : 

13 

14 

52 

14 

£14 

77 

15 

4*- 

* NGOOD  - OWC  PRODUCT  No.  7 
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TABLE  5-13 

DELTA  T*  COLOR  CONVERSION  (DLTFCT) 


DATA 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO. 

DATA 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO. 

0-95 

; 00 

1 

128 

31 

35 

96-99 

04 

2 

129-130 

41 

15 

100-103 

10 

3 

131-132 

21 

16 

104-107 

14 

4 

133-134 

23 

17 

108-109 

34 

5 

135-136 

03 

18 

110-111 

74 

6 

137-138 

02 

19 

' 112-113 

: 64 

7 

139-140 

01 

20 

114-115 

24 

8 

141-142 

07 

21 

116-117 

20 

9 

143-144 

13 

22 

118-119 

40 

10 

145-146 

17 

23 

120-121 

60 

11 

147-148 

15 

24 

122-123 

62 

12 

149-152 

11 

25 

124-125 

63 

13 

153-156 

25 

26 

126-127 

67 

14 

157-160 

52 

27 

‘ 1 
[ 

.1  ; 

161-255 

77 

28 

AT  - ORC  PRODUCT  No.  3 
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TABLE  5-14 

DAY  ISOTHERMAL  (OID)  COLOR  CONVERSION  (DAYISO) 


DATA 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO. 

DATA 

COLOR  INDEX 
(OCTAL) 

0-149 

00 

1 

209 

41 

mm 

150-165 

04 

2 

210 

21 

liiil 

166-175 

, 10 

3 

211 

23 

17 

176-183 

J 14 

4 

212 

! i 

03 

18 

184-189 

34 

5 

213  ' 

02 

19 

1 90-193 

74 

6 

214 

01 

20 

194-195 

64 

7 

215 

07 

21 

196-197 

24 

8 

216 

13 

22 

198-199 

20 

9 

217 

17 

23 

200-201 

40 

10 

218-219 

15 

24 

202-203 

60 

11 

220-223 

11 

25 

204-205 

62 

12 

224-229 

25 

26 

206*207 

' 63 

13 

230-239 

52 

27 

208 

67 

14 

240-255 

77 

28 
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TABLE  5-15 

NIGHT  ISOTHERMAL  (OIN)  COLOR  CONVERSION  (NITISO) 


DATA 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO,  1 

DATA  . 

COLOR  INDEX 
(OCTAL) 

COLOR  BAR 
NO. 

0-141 

00 

1 

193 

41 

15 

142-1S5 

04 

2 

194 

21 

16 

156-165 

, 10 

: 

3 

195 

23 

17 

166-171 

14 

4 

196 

03 

18 

172-175 

34 

5 

197 

02 

19 

176-179 

n ; 74  .. 

i i 

: ■<>  6 

198 

01 

20 

180-181 

64 

7 

199 

07 

21 

182-183 

. 

j 24 

8 

200-201  - 

13 

22 

184-185 

20 

9 

202-203 

17 

23 

186-187 

40 

10 

204-205 

15 

24 

188-189 

60 

11 

206-209 

11 

25 

190 

62 

12 

210-217 

25 

26 

191 

63 

13 

218-227 

52 

27 

192 

67 

14 

228-255 

77 

28 
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TYPE 


NUMERIC 

NUMERIC 

NUMERIC 

NUMERIC 

NUMERIC 

ASCII 

ASCII 

NUMERIC 

ASCII 

NUMERIC 

NUMERIC 

ASCII 

NUMERIC 

ASCII 


TABLE  5-16 

PDGEN  VT05  VARIABLE  FIELDS  (EX:  SSP) 


SEDS 

owe 

01 

NOAA 

00-00-00 


LIMIT 


1,5,8 

0- 3 

1- 8 

1-2200 
32  CHARS 
3 CHARS 
01-63 
8 CHARS 
DD-MM-YY 
0-32767 


SEDS  IMAGE  28  CHARS 
00-00-00  MM-DD-YY 
- 54  CHARS 


DESCRIPTION 


PRODUCT  GENERATOR  MODE 

TOTAL  NO.  OF  IMAGES  OUTPUT  TO  TAPE 

TAPE  UNIT  DEVICE  NO. 

IMAGE  NO.  TO  BE  OUTPUT  TO  DISPLAY 
CURRENT  SCAN  LINE  COUNTER 
SYSTEM  IDENTIFICATION 
OUTPUT  TAPE  IDENTIFICATION 
TAPE  REEL  SEQUENCE  NO. 

SENSOR  IDENTIFICATION 
GENERATION  DATE  OF  DATA 
ORBIT  NO.  OF  DATA  (DAY  PASS) 

JOB  IDENTIFICATION 
DATE-OF-DATA  (DAY  PASS) 

COMMENTS  ENTERED  MANUALLY 


JSC-10019 
Par.t  1 1 


TABLE  5-17 

ANNOTATION  DOT  MATRIX  TABLE  (DMTB) 


DATA 

CHARS. 

DATA 

CHARS. 

DATA 

CHARS. 

01076 

N/A.A.B 

41061  | 

42220 

01051 

(3-CHAR 

group  no.  o; 

41063  ! 

* 

24210 

01751 

41265  | 

10204 

01056 

41271  ! 

24502 

01051 

41561  | 

43041 

00511 

41061  ! 

[ 43077 

00236 

35015 

O.P.Q  ' 

1 00000 

i 

N/A,N/A,N/A 

35737 

C*D»EV  J 

1 43022 

1 00000 

42460 

] . 

| 43025 

1 00000 

40460 

j 43721  j 

! 00000 

40474 

43061 

ooooo 

40460 

j 43061 

00000 

42460 

35716  I 

ooooo 

35737 

i 

| 42704  I 

R.S.T 

ooooo 

N/A.N/A, SPACE 

40761 

F»G»H 

45044  | 

J 

ooooo 

41 061 

50044  1 

ooooo 

41161  ! 

74704  1 

j 

ooooo 

71037  j j 

43004  ] 

ooooo 

41021  1 j 

43044  1 

ooooo 

41021 

74737 

ooooo 

76761 

34221 

u.v.w 

10011  . 

• II  U 
•9  9" 

34721 

| 

I.J.K 

42533 

0001 2 f 

11062 

43065 

10037 

10070 

43065 

10012 

10064 

- - ' ' 

43061 

10537 

10062 

43061 

10512 

34061 

43061 

10512 

77061 

i j ' ' -• 

■ ’ : ■ 

L,M,N 

42237 

X,Y  ,Z 

10155 

$,%,& 

5-230 


TABLE  5-17  (CONT'D) 
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DATA 

Qm  (OCTAL) 


15-BIT  EXPANSION 


N/A,A,B(0) 


123451234512345 


01076 

0 0 O'O  0 

i1 

0 0 0 

1 

irr 

T^NOl 

01051 

0 0 o'o  0 

1 

0 0 0 

1 

0 

1 

OU 

1] 

01751 

0 0 0 0 0 

1 

TTT 

1 

0 

1 

Q_Q 

L1 

01056 

0 o o'o  0 

li 

"ooo 

1 

0 

1 

1 1<D 

01051 

0 0 0 0 0 

Ir 

so  o v 

0 

1 

0 0 

T| 

00511 

0 0 0,0  0 

(J> 

T> 

Si 

1 

00 

l! 

00236 

0 0 0,0  0 

O' 

_0 

11- 

-L. 

1 

2 

3 

4 

5 

6 
7 


N/A  A B 

(0)  (1)  (2) 


X,Y,Z(10q)  42237 

0 42220 

24210 
10204 
24502 
43041 
43077 


123451234512345 

1 
2 

3 

4 

5 

6 
7 


\ 


X Y Z 

(0)  (1)  (2) 


ALGORITHM  FOR  LOCATING  CHARACTERS  IN  DMTB: 

1.  FIND  CHARACTER  A (ASCII  CODE  = 1018) 

6-BIT  LSB  = 018 

DIVIDE  018  BY  3;  QUOTIENT  = 0,  REMAINDER  = 1 
A IS  LOCATED  IN  3-CHAR  GROUP  NO.  0,  INTERNAL  POSITION  NO.  1 

2.  FIND  CHARACTER  Z (ASCII  CODE  = 132s) 

6-BIT  LSB  = 32g 

DIVIDE  32s  BY  3;  QUOTIENT  = lOg,  REMAINDER  = 2 
Z IS  LOCATED  IN  GROUP  NO.  10s,  INTERNAL  POSITION  NO.  2 


Figure  5-26  Binary  Expansion  of  Selected  DMTB  Entries 


JSC-10019 
Part  II 


DATA 

CHARS  1 (OCTAL)  15-BIT  EXPANSION 


N/A,A,B(0)  01076 

01051 
01751 
01056 
01051 
00511 
00236 


1 2 3 4 5 1 2 3 4 5 1 2 3 4 5 


1 

2 

3 

4 

5 

6 
7 


N/A  A B 

(0)  (1)  (2) 


X,Y,Z(10ft)  42237 

42220 
24210 
10204 
24502 
43041 
43077 


12  3 451234512345 


(0)  (1)  (2) 


ALGORITHM  FOR  LOCATING  CHARACTERS  INtDMTB: 

1..  FIND  CHARACTER  A (ASCII  CODE  = 1018) 

6-BIT  LSB  * 018 

DIVIDE  018  BY  3;  QUOTIENT  = 0,  REMAINDER  = 1 
A IS  LOCATED  IN  3-CHAR  GROUP  NO.  0,  INTERNAL  POSITION  NO.  1 

2.  FIND  CHARACTER  Z (ASCII  CODE  = 132s) 

6-BIT  LSB  = 328 

DIVIDE  32s  BY  3;  QUOTIENT  = 10s,  REMAINDER  = 2 
Z IS  LOCATED  IN  GROUP  NO.  10g,  INTERNAL  POSITION  NO.  2 


Figure  5-26  Binary  Expansion  of  Selected  DMTB  Entries 
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truncate  that  character's  7-bit  ASCII  code  to  its  six  LSB's.  Then 
divide  the  6-bit  value  by  3.  The  quotient  defines  the  three- 
character  group  number,  and  the  remainder  is  used  to  locate  the 
character's  position  within  the  group.  Internal  counters  are  used 
to  build  character  vertically  and  horizontally  for  a complete 
seven-line  by  five-pixel  character.  Each  ASCII  input  string  must 
be  terminated,  by  the  octal  code  of  133g. 

5.2. 3. 5 Limitations . The  major  limitations  of  the  SEDS  product 
generation  capability  is  the  product  output  to  tape  for  multi-image 
runs.  For  example,  the  OWC  product  tape  always  contains  all  eight 
images;  the  option  to  output  only  one  or  two  of  these  images  to 
tape  does  not  exist.  In  addition,  a restart  capability  of  tape 
products  is  available  only  through  reinitialization.  Each  product 
or  set  of  products  must  be  processed  from  scan  line  1 to  scan  line 
550,  or  to  scan  line  2200  for  normal-sized  images, 

5.2. 3.6  CPC  Listings.  See  Part  IV  of  this  document,  published 
under  separate  cover. 
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SECTION  6 


DISPLAY  AND  PRODUCT  GENERATOR  (DPG)  PROGRAM 


6.1  GENERAL  PROGRAM  CHARACTERISTICS 

The  DPG  Program  in  SEDS  is  used  to  display  SEDS  image  product 
tapes,  to  perform  universal  format  tape-to-tape  edits,  to  edit 
visible  channel  data  from  registered  data  disk  to  tape,  and  to 
build  selected  SEDS  image  products.  The  DPG  Program  consists  of 
four  major  components  or  modules  --  DPG,  UEDIT,  VSTRIP,  and 
DWPGEN.  . „ H . . . ; 

6.1.1  Functional  Allocation.  As  described  in  PHO-TN734,  DPG 
provides  a comprehensive  image  screening  and  editing  processing 
capability.  The  SEDS  operator  can  view  product  maps  from  singly  j 
ori  multiimage  tapes.  This  option  is  especially  useful  for  the 
multiimage  tapes  for  products  not  monitored  during  the  product 
generation  phase.  All  product  images  may  be  visually  inspected 
prior  to  being  forwarded  to  the  Production  Film  Converter  for 
film  processing. 

6.1.2  Program  Flow  Chart.  See  figure  6-1. , 

6.1.3  Program  Timing  and  Sequencing.  DPG  is  designed  to  be  run 
at  any  time  following  SEDS  initialization  when  image  screening 
or  image  editing  is  required.  Proper  program  configuration  in- 
cludes such  items  as  loading  the  correct  9-track  tape  or  regis- 
tered disk  as  input,  and  the  SEDS  display  and  blank  tapes  for 
output.  Program  initialization  and  control  is  through  selected 
VT05  entries.  Input  tape  reads  are  controlled  by  start  and  stop 
scan  line  numbers,  and  the  displayed  image  is  controlled  by  start 
and  stop  pixel  numbers.  Visible  Channel  data  from  registered 
disk  includes  550  scan  lines  containing  625  elements. 

6.1.4  Storage  Allocation.  The  storage  requirements  for  DPG  are 
shioWn  in  figure  6-2.  As  shown  in  the  diagram,  all  four  components 
of1  DPG  use  12K  instruction  space.  In  addition,  each  module  utilizes 
the  4K  segmentation  buffer,  D3UFF,  for  tape  input/output  and  link- 
age between  modules.  The  DPG  module  (not  to  be  confused  with  the 
DPG  Program,  the  name  given  to  this  program  in  SEDS)  provides  pro- 
gram initialization  and  control,  input  tape  control  and  image 
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Figure  6-1  (Cont'd) 
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Figure  6-2  DPG  Storage  Allocation 


Reproducibility  of  Ur 
6-4  ORIGINAL  PAGE  IS  POOH 


JSC-10019 
Part  II 


screening.  The  UEDIT  module  of  the  DPG  Program  uses  the  input  tape 
information  stored  in  DBUFF  to  perform  tape-to- tape  editing.  The 
VSTRIP  module  reads  the  visible  channel  from  the  registered  disk, 
and  writes  a universal  format  tape  which  is  blocked  similarly  to 
the  compressed  OID/OIN  tapes  described  in  figure  5-23.  The 
DWPGEN  module  is  a composite  of  the  same  product  generator  sub- 
routines described  in  paragraph  5.2.3  (SWPGEN)>  of  this  specifica- 
tion. 

6.1.5  Data  Base  Characteristics 

A.  File  Description.  The  common  files  of  DPG  consist  pri- 
marily  of  DBUFF  and  SCOMVT.  DBUFF  is  a 4K  storage  buffer 
used  for  tape  input/output  sequencing  between  the  DPG 
module  and  the  other  three  modules.  The  content  of  DBUFF 
assumes  the  format  of  header  or  data  records  of  the  9- 
track  universal  format  tapes  that  are  being  read  or  writ- 
ten. SCOMVT  serves  as  a 256-word  common  storage  buffer 
area  for  linkage  to  all  four  modules.  Most  of  the  SCOMVT 
buffer  space  is  used  for  storage  of  the  header  record 
constants  from  the  input  universal  format  tape. 

B.  Program  Constants.  The  following;  six  parameters  serve  as 
DPG  controlling  constants.  The  last  five  are  controlling 
parameters  for  the  universal  tape  format  read. 

• MODE  - Program  operation  mode 

• PIXS.TR  - Start  pixel  number 

• PIXNBR  - Number  of  pixels 


• SCNSTR  - Start  scan  line  number 

• SCNSTP  - Stop  scan  line  number 

• CHNL  - Channel  number  , 
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6.2  DPG  CPC  CHARACTERISTICS 

This  paragraph  contains  a detailed  technical  description  of  the 
computer  program  components  identified  in  paragraph  6.1  of  this 
specification.  The  instruction  listings  contained  herein,' by 
inclusion  or  reference,  specify  the  exact  configuration  of  the 
DPG  Program. 

6.2.1  DPG  Module.  The  controlling,  tape  reading,  and  image 
screening  component  of  the  DPG  Program  is  the  DPG  module.  Its 
functions  have  been  previously  defined  in  pragraph  6,1.  The 
module  is  composed  of  several  separate  and  distinct  subcomponents. 
One  subroutine,  DPGDRV,  is  written  in  PDP-11  FORTRAN  and  acts  as 
the  driver  linking  the  DPG  Program  with  the  SEDS  system  control. 
The  remaining  subcomponents  of  the  DPG  module  are  written  in  PDP- 
11/45  assembly  language. 

6. 2.1.1  Subcomponent  Descriptions 

A.  DPGDRV.  This  subcomponent  of  the  DPG  module  is  the  DPG 
driver  routine  of  SEDS.  DPGDRV  is  necessary  because  of 
the  system  segmentation  and  overlay  software  utilized  by 
SEDS. 

B.  "DPG."  This  is  the  name  given  to  the  main  subcomponent 
of  the  DPG  module.  As  previously  stated  in  this  specifi- 
cation, user  control,  input  tape  processing,  and  image 
screening  are  the  primary  functions  of  the  DPG  module. 

User  control  is  through  the  VT05  alphanumeric  display 
terminal.  VTLINK  is  the  routine  directly  called  to  set 
up  linkage  between  the  user  and  the  VT05.  The  DPG- 
initialized  VT05  display  is  shown  in  figure  6-3.  All 
error  messages  and  operator  advisory  instructions  are  out- 
put to  the  VT95.  Tape  input  is  performed  through  inter- 
face with  the  Universal  format  tape  read  routine,  U9TRD. 

C.  U9TRD.  This  is  the  subroutine  called  to  read  9-track, 
universal  format,  CCT's.  User  inputs  to  DPG,  such  as 
the  start  and  stop  scan  line  numbers,  the  start  pixel 
number,  and  the  channel  number  control  tape  input  sequencr 
ing*  The  call  packet  to  U9TRD  is  specified  in  figure  6-4, 
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Figure  6-3  DPG  Initialized  VT05  Display 
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CALL  TO  U9TRD: 

JSR  R5,@#U9TRD 

BR  A 

.WORD  PACKET  i INPUT  PACKET 

.WORD  DAT ADR  ; RETURNED  DATA  ADR 

.WORD  STATUS  ; RETURNED  STATUS  CODE 


• PACKET.  6-WORD  BUFFER  CONTAINING  CONTROL  INFORMATION  FOR 
TRPFTEAD 

t DATADR.  16-BIT  ADDRESS  OF  START  PIXEL  NO.  LOCATED  WITHIN 

THE  Buffer  specified  in  sth  word  of  packet  buffer  (packet+io) 

• STATUS.  CONTAINS  RETURNED  STATUS  CODE  FOLLOWING  EACH  CALL 
TO  U9TRD. 


PACKET: 

+2 

+4 

+6. 

+8 


+10. 

EQUEST  OPTION  (BITS  8,13-15): 

8 - SET  IF  MEADE*  READ 

13  - SET  IF  INHIBIT  VT05  MESSAGES 

14  - SET  IF  RESTART 

15  - SET  IF  NO  BYTE  REORDERING 


Figure  6-4 


U9TRD  Calling  Sequence 
and  Packet  Format 
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STATUS  CODES  RETURNED  IN  USER'S  "STATUS"  WORD: 


It  14  IS  It  11  10  • • 7 4 S 4 It  1 O 

= END  OF  SCAN  LINE 

= HEADER  RECORD  READ 

- END  OF  RUN  (FOUND 
STOP  SCAN  LINE)  j 

= END  OF  FILE  OR 
END  OF  TAPE 

= PARTIAL  SCAN  LINE 
'(MULTICHANNEL  READ) 

= HEADER  RECORD  ERROR 

- TAPE  DEVICE  ERROR 
(N  = NO.  OF.  SCAN  LINES 

LOST) 


« TAPE  READ  ABORTED  (25 
CONSECUTIVE  SCAN  LINES 
♦DENOTES  ADVISORY  MESSAGE  OUTPUT  LOST) 


NOTES: 

1)  SOME  STATUS  CODES  HAVE  HIGHER  PRIORITY;  E.I.,  HEADER  RECORD 
ERROR  (5)  WOULD  BE  RETURNED  OVER  CODE  1 

2)  STATUS  CODE  6 WILL  BE  RETURNED  WHEN  THE  NEXT  VALID  SCAN  LINE 
IS  FOUND 

3)  TABLE  6-1  EXPLAINS  THE  SEDS  TAPE  ID  CODE  RETURNED  IN  THE  UPPER 
BYTE  WITH  STATUS  CODE  1 , 


Figure  6-4  (Cont'd) 
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and  table  6-1.  The  segmentation  buffer,  DBUFF,  serves  as 
the  tape  input  buffer.  The  status  codes  returned  to  the 
user  upon  each  call  to  U9TRD  keeps  him  informed  of  the  tape 
read  status  and  requested  data  location.  The  user  should 
call  U9TRD  for  each  channel’s  worth  of  data  required.  In 
addition  to  the  various  software  status  codes  returned  to 
user,  VT05  advisory  messages  may  be  output  to  inform  the 
operator  of  input  status.  The  initial  call  to  U9TRD  should 
request  that  the  first  (or  header)  record  be  read.  From 
the  information  supplied  in  the  header  record,  a search 
algorithm  is  defined  to  continuously  space  the  tape  forward 
from  start  to  stop  scan  line.  An  address  is  returned  to 
the  user  specifying  where  the  first  pixel  of  the  requested 
data  is  located.  If  the  records  of  a scan  line  or  data 
set  contain  parity  errors  upon  read,  the  scan  line  or  data 
set  is  not  returned  to  the  user;  instead,  tape  read  is 
tried  until  25  scan  lines  are  lost  before  an  abort  condi- 
tion exists. 

6. 2. 1.2  Flow  Charts.  See  the  61  pages  following  table  6-1. 
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T#BLE  6-1 

SEDS  9-TRACK  TAPE  INFORMATION 


TAPE  NAME 


"U9TRD"  ID 
RETURNED 


TAPE  ID 


REG  INTERMEDIATE 
RAW  PCM  DAY 
RAW  PCM  NIGHT 
EU  DAY 
EU  NIGHT 
REG  DAY 
REG  NIGHT 
SPARE 

ISOTHERMAL  DAY 
ISOTHERMAL  NIGHT 
DATA  BASE 
RAINFALL 
SCREWWORM 
MOISTURE  INDEX 
UPDATE 


0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 


CRT 

SPD| 

SPN 

sed! 

SEN1 

SMD 

SMN 

01 D* 
01 N* 
OBC 
ORC* 

owe* 

CMI 

SBC 


* DENOTES  SEDS  IMAGERY  PRODUCTS  TAPES 
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6. 2.1.3  Interfaces 

A.  Input  Data.  The  input  to  the  DPG  module  is  from  magnetic 
tapes.  The  data  records  going  into  DPG  take  the  form  of 
the  specific  universal  format  tape  being  handled  by  U9TRD. 
One  channel  of  each  scan  line  is  passed  to  DPG  via  the  tape 
input  buffer. 

B.  Output  Data.  The  primary  function  of  the  DPG  module  is  to 
interrogate  user  inputs  via  VT05  entries.  However,  another 
function  exists;  it  is  the  display  screening  capability. 

The  data  input  from  tape  is  passed  on  to  the  SEDS  display 
for  line-by-line  video  screening. 

6. 2. 1.4  Data  Organization.  The  primary  internally  defined  items 
of  interest  in  the  DPG  module  are  those  associated  with  the  VT05 
display  for  user  input  (see  figure  6-3).  Paragraph  6 . 1~.  5 , B ex- 
plains in  detail  the  VT05  constants. 

6. 2. 1.5  Limitations . The  major  limitation  to  the  screening  capa- 
bility of  the  DPG  module  is  the  speed.  Line-by-line  image  screen- 
ing time  is  slowed  by  the  input  tape  read.  Universal  format  tapes 
containing  several  channels  per  scan  line,  which  require  multiple 
tape  records  per  scan  line,  must  be  read  and  discarded  in  order  to 
find  the  record  containing  the  channel  being  screened.  This  prob- 
lem of  tape  length*' is  somewhat  minimized  by  editing  onto  another 
tape  only  the  channels,  pixels,  and  scan  lines  required  for 
screening. 

6. 2. 1.6  Listings . See  Part  IV  of  this  document  published  under 
separate  cover. 

6.2.2  UEDIT . This  module  provides  tape-to-tape  editing  of  uni- 
versal format  tapes.  Editing  to  an  output  tape  is  accomplished 
by  specifying  through  VT05  inputs  the  information  required  from 
the  input  tape.  A compression  factor  is  then  used  to  determine 
the  image  size.  Using  the  information  entered  via  the  VT05 
(shown  in  figure  6-5)  as  an  example,  a universal  format  tape  will 
be  written  on  magnetic  tape  unit  No.  2 containing  one  channel, 

125  pixels,  and  110  scan  lines.  The  UEDIT  module  is  composed  of 
several  separate  and  distinct  subcomponents.  One  subroutine, 
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6-5  UEDIT  VT05  Display 
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UEDRV,  is  written  in  PDP-11  FORTRAN  and  serves  as  the  linking 
driver  between  the  UEDIT  and  DPG  modules.  The  other  subcom- 
ponent of  UEDIT  are  written  in  PDP-11/45  assembly  language. 

•6 . 2 . 2 . 1 Subcomponent  Descriptions 

A.  UEDRV.  This  subcomponent  of  the  UEDIT  module  is  the  link 
ing  driver  with  the  DPG  module. 

B.  "UEDIT."  This  is  the  main  subcomponent  of  the  UEDIT 
module.  It  accepts  user  inputs  via  the  VT05  and  controls 
the  edited  data  being  output  to  tape. 

C.  U9WRT.  This  is  the  universal  format  write  subroutine 
previously  discussed  in  paragraph  5.2. 3.1  of  this  specifi- 
cation. 

6. 2.2.2  Flow  Charts.  See  the  next  five  pages. 
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6.2. 2.3  Interfaces 

A.  Input  Data.  The  input  data  to  the  UEDIT  module  comes  via 
the  DPG  module  from  ^he  universal  format  input  tape.  A 
buffer  containing  one  channels  worth  of  data  is  passed  on 
for  editing. 

B.  Output  Data.  The  input  data  is  compressed  according  to 
specification  and  output  to  magnetic  tape  in  the  universal 
format. 

6. 2. 2.4  Data  Organization.  The  principle  internally  defined  items 
in  the  UEDIT  module  are  the  compression  factor  and  the  call  packet 
to  U9WRT.  The  compression  factor  is  an  integer  ranging  from  1-9. 

6. 2. 2. 5 Limitations.  The  tape  editing  capability  in  the  UEDIT 
module  is  limited  to  three  channels  at  a time.  In  addition, 
only  a compression  function  is  available;  there  exists  no  func- 
tion for  "zooming"  or  increasing  the  size  of  a specified  area. 

6.2. 2.6  Listings . See  Part  IV  of  this  document  published  under 

separate  cover. 

6.2.3  VSTRIP.  The  VSTRIP  module  provides  the  registered  disk-to- 
tape  editing  function.  One  of  the  outputs  of  the  registration 
phase  of  SEDS  is  a disk  file  containing  three  images,  one  of  which 
is  called  the  visible  channel.  This  image  contains  550  scan  lines 
with  625  pixels  per  scan  line.  The  purpose  of  VSTRIP  is  to  trans- 
fer this  visible  data  to  tape  in  the  universal  format.  The  VSTRIP 
module  consists  of  several  separate  and  distinct  subcomponents. 

One  subroutine,  VSTDRV,  is  written  in  PDP-11  FORTRAN  and  serves 
as  the  interface  driver  between  VSTRIP  and  the  DPG  module.  The 
other  subcomponents  of  VSTRIP  are  written  in  PDP-11/45  assembly 
language . 

6.2. 3.1  Subcomponent  Descriptions 

A.  VSTDRV.  This  subcomponent  is  the  linking  driver  with  the 
DPG  module. 

B.  "VSTRIP."  This  is  the  main  subcomponent  of  the  VSTRIP 
module.  It  handles  the  buffer  sequencing  for  the  disk 
reads  and  the  tape  writes. 
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C. 


D. 


E. 


DSKFIX.  This  subroutine  sets  up  disk  file  allocation 
and  the  read  function. 


DSKOP.  This  subroutine  is  called 
at  a time  of  visible  channel  data 
on  the  registered  disk. 


to  read  four  scan  lines 
from  the  SEDREG.DAT  file 


U9WRT.  This  is  the  same  universal  format  tape  write  sub 
routine  discussed  in  paragraph  5. 2. 3.1  of  this  document. 


6>2.3.2  Flow  Charts.  See  the  following  three  pages. 
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6.2. 3. 3 Interfaces 

A Input  Data.  The  input  data  to  VSTRIP  resides  in  the  regis- 
' tered  disk  file  SEDREG.DAT.  The  visible  channel  data  is 
read  from  the  disk  records  named  DAY  VISIBLE  DATA  as  she™ 
by  figure  6-6.  Every  third  disk  record  contains  four  scan 
lines  of  visible  data. 

B.  Output  Data.  The  output  data  is  passed  on  to  U9WRT  for 
universal  format  tape  write. 

6. 2. 3. 4 Data  Organization.  The  internally  defined ^TOWRT^All 
VSTRIP  are  the  entries  required  m the  call  packet  to  Up  - 
values are  fixed  except  the  input  buffer  address  is  variable. 

fi_2.3.5  Limitations.  The  limiting  feature  of  VSTRIP  is  its  capa- 
h litv  of  "editing"  Mly  the  visible  channel  from  registered  disk 
to  tape.  The  program  run  time  is  good  in  that  it  takes  only  a ou 

2 minutes. 

6. 2. 3. 6 Listings.  See  Part  IV  of  this  document  published  under 
separate  cover. 

624  DWPGEN.  This  is  the  product  generation  module  of  DPG. 

Its* function  is  the  generation  of  SEDS  output  products,  display 
and/or  tape?  The  short  circuit  feature  of  product  generation  has 
proved  useful  in  the  debug  and  checkout phases  of  all  e 

subroutines,  as  well  as  the  bypass  of  the  standard  SEDS  produc 
tion  sequence  to  obtain  specific  products  and  results. 

6.2. 4.1  Subcomponent  Descriptions.  All  of  the  subcomponents 

listed  and  discussed  in  paragraph  5.2. 3.1  of  this  document  are 
also  used  in  the  DWPGEN  module.  See  that  paragraph  for  details 
of  the  following  subcomponents: 

• PDGEN 

• OWCPRO 

• FCGEN 


U9WRT 
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FILE  NAME 


SEDREG.HDR  (5670g) 


(15,500g) 

(22,404g) 


SEDREG^DAT 
(625-BYTES/ 
SCAN  OlNE,  ( 
4 SCAN  LINES/ 
RECORD) 


(27 ,310g) 


HEADER  RECORD 
( 3000-j 0 BYTES) 

RECORD  1 
(NIGHT  IR  DATA) 

RECORD  2 
(DAY  IR  DATA) 

RECORD  3 

(DAY  VISIBLE  DATA) 

RECORD  412  , 

(NIGHT  IR  DATA) 

RECORD  413 
(DAY  IR  DATA) 

RECORD  414 
(DAY  VISIBLE  DATA) 

J 


J 


COMPRESSED  SCAN  LINES  1-4 
250010  BYTES  (4704q) 


COMPRESSED  SCAN  LINES 
549-550,  250010  BYTES 


Figure  6-6  SEDS  Registered  Disk 
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• DISPL 

• OPNOT 

• ANNOT 

6.2.4. 2 Flow  Charts.  See  flow  charts  following  paragraph  5.2. 3.2 

6.2. 4. 3 Interfaces 

A.  Input  Data.  Unlike  input  to  the  SWPGEN  module  in  SSP  and 
the  other  product  generator  modules,  input  to  DWPGEN  is 
from  tapes.  The  input  tape  type  depends  upon  the  output 
product  to  be  generated.  For  example,  an  intermediate 
registered  day  isothermal  tape  (SMD)  may  be  read  to  out- 
put a DAY  ISOTHERMAL  (OID) ' color -coded  image. 

B.  Output  Data.  The  output  of  DWPGEN  parallels  that  of 
SWPGEN  in  that  it  may  be  output  to  tape  and/or  display 
as  color-coded  images. 

6. 2. 4. 4 Data  Organization.  The  subcomponents  of  DWPGEN  are 
identical  to  those  of  SWPGEN.  See  paragraph  5. 2. 3. 4 of  this 
document  for  detailed  data  organization. 

6.2.4. 5 Limitations . Due  to  the  complexity  of  the  input  data 
to  Data  Base  Sequences  No.  1 and  2,  only  the  false  color,  tape, 
and  display  formats  of  the  ORC  and  OWC  products  may  be  simulated 
with  DWPGEN. 

6. 2. 4. 6 Listings . See  Part  IV  of  this  document  published  under 
separate  cover. 
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SECTION  7 

CHARACTER  DENSITY  PLOT  (CDP)  PROGRAM 


7.1  GENERAL  PROGRAM  CHARACTERISTICS 

The  CDP  Program  in  SEDS  is  used  to  generate  line  printer  maps  using 
the  registration  intermediate  tapes  (SMD  or  SMN)  as  input.  The 
line  printer  plots  may  be  used  in  lieu  of  the  film  images.  In 
addition,  CDP  provides  an  expanded  "quick-look"  at  daily  registered 
data.  CDP  consists  of  only  one  module.  Its  basic  configuration 
is  described  by  figure  7-1. 

7.1.1  Functional  Allocation.  As  defined  in  PHO-TN734  , CDP.  performs 
the  output  of  character  density  maps  on  the  line  printer.  In  order 
to  provide  a 1:1  aspect  ratio,  it  is  necessary  to  expand  the  data 
along  the  X axis  using  a nearest-neighbor  value  assignment  tech- 
nique . 

7.1.2  Program  Flow  Chart.  See  figure  7-2. 

7.1.3  Timing  and  Sequencing.  The  data  from  tape  must  be  input 
and  must  reside  within  a specified  buffer  area.  The  algorithm  to 
preserve  the  X-Y  aspect  ratio  is  executed  as  the  data  is  converted 
to  printable  characters  for  output.  The  run  time  depends  upon  the 
tape  length  and  image  size  to  be  printed. 

7.1.4  Storage  Allocation.  The  storage  requirements  for  CDP  are 
shown  in  figure  7-3.  As  illustrated  by  the  diagram,  the  instruc- 
tion space,  buffers,  and  conversion  tables  require  only  5K  core 

s torage . 

7.1.5  Data  Base  Characteristics.  CDP  Program  constants  are  lo- 
cated in  a SEDS  common  buffer  space  called  SCOMVT.  The  common 
area  contains  256  words.  The  first  100  words  are  reserved  for 
VTO 5 input  and  output  control.  The  next  70  words  are  reserved 
for  header  information  from  universal  format  tape  reads  set  up  by 
U9TRD . The  remaining  words  are  spares  and  are  used  differently 
by  various  programs  in  SEDS.  A more  detailed  description  of  this 
common  area  is  shown  by  the  computer  program  listings  of  CDP. 
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Figure  7-2  CPC  Program  Flow  Chart 
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Figure  7-3  CDP  Storage  Allocation 
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7.2  CDP  CPC  CHARACTERISTICS  (CDPEXC) 

Paragraph  7.2  contains  a detailed  technical  description  of  the  CDP 
Program.  The  instruction  listings  contained  herein,  by  inclusion 
or  reference,  specify  the  exact  configuration  of  the  CDP  Program. 

The  name  of  the  combined  subcomponents  of  CDP  is  CDPEXC;  its.  func- 
tions have  been  previously  defined  in  paragraph  7.1.  This  module 
is  composed  of  several  separate  and  distinct  subcomponents.  One 
subroutine,  CDPDRV,  is  written  in  PDP-11  FORTRAN  and  serves  as  the 
driver  linking  the  CDP  Program  with  the  SEDS  system  control  module. 
The  other  subcomponents  of  CDPEXC  are  written  in  PDP-11/45  assembly 
language . 

7.2.1  Subcomponent  Descriptions 

A.  CDPDRV.  This  subcomponent  is  the  CDP  driver  routine  of 
SEDS.  This  routine  exists  because  of  the  system  segmenta- 
tion and  overlay  software  utilized  by  SEDS. 

I 

B.  MCDP . M This  is  the  name  of  the  main  subcomponent  of  the 
CDPEXC  module.  This  subcomponent  provides  the  initializa- 
tion, user  control,  and  process  sequencing  of  all  functions 
performed  by  the  CDP  Program.  User  control  is  accomplished 
through  the  VT05,  whose  initialized  state  is  shown  in  fig- 
ure 7-4.  Error  messages  and  operator  advisory  instructions 
are  output  to  the  VT05  display.  Tape  input  is  performed 
through  interface  with  the  subroutine  U9TRD.  The  pixel- 
to-ASCII  character  conversion  table  is  contained  in  the 
TEMTB  subcomponent. 

C.  TEMTB . This  is  the  ASCII  character  conversion  table.  The 
listings  in  Part  IV  of  this  specification  show  in  detail 
the.  content  and  layout  of  this  256-item  table. 

D.  U9TRD.  This  is  the  universal  format  tape  read  routine 
described  in  paragraph  6. 2. 1.1, C of  this  document. 

7.2.2  Flow  Charts . See  16  pages  following  figure  7-4. 
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7.2.3  Interfaces 

A.  Input  Data.  The  input  data  to  CDP  is  from  universal  for- 
mat magnetic  tapes.  The  data  records  take  the  form  of  the 
specific  tape  being  processed  and  handled  by  U9TRD.  One 
channel  of  each  scan  is  passed  to  CDP  via  tape  input  buf- 
fers . 

B.  Output  Data.  The  input  data  is  decoded  and  converted  to 
ASCII'  characters  to  be  output  to  the  line  printer. 

7.2.4  Data  Organization.  The  principle  internally  defined  items 
in  CDP  are  those  associated  with  the  VT05  display  for  user  input. 

7.2.5  Limitations,  The  major  limitation  of  CDP  is  the  processing 
sneed.  Operation  time  is  affected  by  the  tape  read  and  the  time 
required  for  line  printer  output.  In  addition,  the  bulk  of  paper 
required  to  output  sizable  images  make  CDP  inconvenient  at  times. 

7.2.6  Listings . See  Part  IV  of  this  document  published  under 
separate  cover. 
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SECTION  8 
SYSTEM  SOFTWARE 


8.1  GENERAL  SYSTEM  SOFTWARE  CHARACTERISTICS 

The  system  software  for  SEDS  consists  of  three  kinds  --  the  PDP-11 
Disk  Operating  System  (DOS)  and  its  associated  system  programs; 
the  system  support  software  previously  developed  by  SISO  for  the 
Preprocessor  Subsystem  of  the  Earth  Resources  Production  Processor 
System  (ERPPS) ; and  the  newly  developed  system  software  provided 
by  SISO  for  SEDS,  which  handles  the  custom  built  display  hardware 
and  associated  special  needs.  The  special  system  software  imple- 
mented for  SEDS  will  be  covered  in  this  section.  Refer  to  PHO- 
TR545,  Section  3,  for  an  explanation  of  DEC  and  preprocessor  sys- 
tem software. 

8.2  SYSTEM  SOFTWARE  CPC  CHARACTERISTICS 
8.2.1  Subcomponent  Descriptions 

A.  VTIN.  This  is  the  SEDS  VT05  input  service  routine  which 
handles  and  services  all  VT05  keyboard  interrupts.  The 
interrogation  and  dispoisiton  of  these  keyboard  interrupts 
are  dependent  upon  the  composition  of  the  static  and  change- 
able fields  of  the  VT05  display.  The  master  buffer  set  up 
by  VTLINK  is  used  as  the  controlling  factor.  In  addition, 
special  processing  is  included  to  interrogate  special  SEDS 
VT05  commands  and  program  names,  and  to  route  control  as 
requested. 

B.  VTOUT . This  is  the  SEDS  VT05  display  terminal  output  in- 
terrupt service  routine.  Its  purpose  is  to  chain  all  out- 
put requests  from  the  VT05. 

C.  VTQ5H.  This  is  the  VT05  display  input/output  request 
handler.  The  communication  link  between  user  software 
and  the  VT05  is  accomplished  through  a number  of  defined 
I/O  request  packets;  these  packets  and  their  functions  are 
described  in  figure  8-1.  The  length  of  the  call  packet  to 
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STATUS  WORD 


ts  14  13  12 

11  10  9 8 

7 

6 

5 4 3 2 1 0 

1 1 1 

1 1 1 

— r i — « i f 

NOT 

USED 

FUNCTION 

CODE 

NOT  USED 

i — i — i — 

i i i — . 

i i i i — i — 

Hr  BUSY 
- — ERROR 


FUNCTION  CODES 

0 = OUTPUT  BY  PARAMETER  ADDRESS 
] = OUTPUT  BY  LINE/COLUMN  NO. 

2 = OUTPUT/STORE  IN  MASTER  BUFFER  BY  LINE/COLUMN  NO. 

3 = INPUT  BY  LINE/COLUMN  NO. 

4 = POSITION  (CURSOR)  BY  LINE/COLUMN  NO. 

5 = INITIALIZE  MASTER  DISPLAY  BUFFER  TO  SPACES  AND  ERASE  THE  SCREEN 

6 = REFRESH  VT05  SCREEN 

7 = MESSAGE  TO  LINE  1 /COLUMN  41  (MAXIMUM  32  CHARACTERS  IN  LENGTH) 

8 = ERASE  ERROR  MESSAGE 

9 = MOVE  CURSOR  TO  PARAMETER  FIELD 
10  = ERASE  PARAMETER  FROM  SCREEN 

NOTE:  ERROR  CODE  SHOULD  BE  CHECKED  UPON  RETURN  FROM  A VT05  OUTPUT  REQUEST. 

THE  REQUESTED  FUNCTION  IS  ABORTED  IF  AN  ERROR  IS  DETECTED  IN  THE 
DISPLAY  I/O  REQUEST  PACKETS. 

CODE  0 - OUTPUT  BY  PARAMETER  ADDRESS 


CODE  1 - OUTPUT  BY  LINE/COLUMN  NO. 


Figure  8-1  VT05  Display  I/O  Request  Packets 
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CODE  7 - MESSAGE  TO  LINE  1/COL.  41 
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ADDRESS 

OF  BUFFER* 

★ASCII  CODED  MESSAGE  MUST  BE  FOLLOWED-  BY  TWO  LINE  FEED  CHARACTERS  (12g) 


CODE  8 - ERASE  ERROR  MESSAGE 
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CODE  9 - MOVE  CURSOR  TO  PARAMETER  FIELD 

19  14  13  12  tt  10  • 8 7 8 9 4 3 2 JO 


CODE  10  - ERASE  PARAMETER  FROM  SCREEN 
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ADDRESS  OF 
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Figure  8-1  (Cont’d) 
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VT05  varies  from  one  to  four  words,  depending  upon  the 
function  requested.  The  call  to  VT05H  is  accomplished 
by  placing  the  address  of  the  packet  on  the  stack  and 
issuing  an  EMT  call,  as  follows: 

MOV' # PACKET, - (SP) 

EMT  142 
TSTB  PACKET 
BNE  . - 4 

The  low  byte  of  the  first  word  is  checked  for  nonzero  for 
busy  and  error  condition. 

D.  VTLINK . This  is  a VT05  routine  called  directly  by  the  user 
program  to  set  up  VTG5  interface  and  control.  A particular 
VT05  display  is  initialized  and  is  set  up  for  user  change- 
able and  static  fields.  This  capability  requires  the  user 
to  code  two  tables.  The  first  is  called  the  initialized 
VTO 5 display  buffer,  and  may  contain  up  to  1440  ASCII 
characters  (20  lines  by  72  characters) ; it  is  preceded  by 

a four-byte  header  and  followed  by  two  ASCII  line  feed  char- 
acters. The  second  table  must  immediately  follow  the  first; 
the  number  of  entries  in  this  second  table  is  determined 
by  the  number  of  input  changeable  fields  available  to  the 
user;  each  changeable  input  field  requires  a three- to-six- 
word  packet  with  specific  information  about  that  particular 
input  entry.  This  table  is  terminated  with  a one-word 
entry  containing  a -1.  The  formats  of  these  two  tables 
are  shown  in  figure  8-2.  Six  internal  VT05  linkage  tables 
are  initialized  and  set  up  by  VTLINK  from  the  initial  call. 
Figure  8-3  shows  in  detail  the  content  and  format  of  these 
six  internal  tables. 

E.  CCTII.  This  is  a 9-track  tape  handler  designed  to  provide 
a fast  interrupt-driven  read/write  capability  outside  the 
DOS  for  9- track  tape.  CCTH  is  entered.  from  the  DOS  EMT 
handler  at  the  address  specified  in  the  monitor  residency 
table,  MRT . The  interrupt  portion  of  CCTH  (CCTINT)  is  en- 
tered from  the  interrupt  vector  when  the  done  interrupt  is 
to  be  serviced.  The  9-track  tape  handler  requires  that  the 
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VT05  DISPLAY  OUTPUT  BUFFER  FORMAT 


CALLING  SEQUENCE:  MOV  #LABEL,RO 

JSR  R5,VTLINK. 

DISPLAY  BUFFER  (TABLE  1) 


LABEL:  +0 

+2 


+2n 


II  14  11  IS  11  10  • • 

7 • S 4 3 1 1 0 

— 1 I T 1 1 f » 

i r i t i i i 

ID  CODE 

SPARE 

START  COL  NO. 

START  LINE  NO. 

L CODED  DISPLAY  i 

[ BUFFER  (ASCII) 

LF 

i i i — t — i — i — i — 

LF 

■■  ,.,t 1 Li,,  1,  -1 i 1 

1.  CODED  DISPLAY  BUFFER  MUST  BE  PRECEDED  BY  FOUR  8-BIT  BYTES  CONTAINING 
DISPLAY  ID  CODE,  SPARE,  START  COLUMN  NO.,  AND  START  LINE  NO., 

RESPECTIVELY. 

2.  TO  TERMINATE  AN  ASCII  CODED  LINE,  IF  LESS  THAN  72  CHARACTERS,  FOLLOW  CODE 
WITH  ONE  LINE  FEED  (LF).  TWO  CONSECUTIVE  LINE  FEED  CHARACTERS  DESIGNATE 
THE  END  OF  THE  DISPLAY  BUFFER. 

3.  TO  OMIT  LINE(S) , FOLLOW  THE  LF  WITH  A CARRIAGE  RETURN  (CR)  INDICATING  THAT 
THE  NEXT  TWO  BYTES  CONTAIN  THE  NEXT  LINE  NO.  AND  COLUMN  NO. 


Figure  8-2  VTOS  Display  Linkage 
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INPUT  PARAMETER  BUFFER  (TABLE  2) 

.BYTE  XX, YY  (XX  = LINE  NO.,  YY  = COLUMN  NO.) 

IS14  13  IX  11  10  B 8 7 6 5 6 3 2 10 


+0 

— i — i — i — i — » — i — i — 

COL  NO. 

— i — i — i — till' 

LINE  Mb. 

+2 

SPECIAL  CODE 

NO.  OF  CHARS 

+4 

ADDRESS  OF  PARAM  VALUE 

+6 

UPPER  LIMIT  OF  PARAM  VALUE 

*8 

LOWER  LIMIT  OF  PARAM  VALUE 

+10 

SPECIAL  PROCESSING  ENTRY  POINT 

ADR  OF  SPECIAL  PROCESSOR  PACKET 

FORMAT 

_ARRAY 

WILL  BE  DETERMINED  BY  SPECIAL 
CODE  (UPPER  BYTE  OF  WORD  +2) 


SPECIAL  CODES  (WORD  +2,  HIGH  BYTE): 

0 = SET  FIELD  OPERATOR  CHANGEABLE.  INITIAL  VALUE  EXPECTED  TO  BE  IN  BINARY. 

INPUT  STORED  IN  BINARY  AFTER  LIMIT  CHECK 

1 = FIELD  NOT  OPERATOR  CHANGEABLE,  OUTPUT  ONLY 

2 = FIELD  IS  OPERATOR  CHANGEABLE.  INPUT/OUTPUT  IN  ASCII.  EXPECTS  WORD  +10  TO  BE 

A SPECIAL  PROCESSOR  ADDRESS  OR  THE  LABEL  "VINEXT" 

3 = FIELD  IS  OPERATOR  CHANGEABLE.  SAME  AS  CODE  2 EXCEPT  INPUT/OUTPUT  IN  BINARY 

4 = FIELD  IS. OPERATOR  CHANGEABLE.  SAME  AS  CODE  2 EXCEPT  INITIAL  UPDATE  OF 

VT05  SCREEN  IS  INHIBITED. 

5 = FIELD  IS  OPERATOR  CHANGEABLE.  SAME  AS  CODE  3 EXCEPT  INITIAL  UPDATE  OF 

VT05  SCREEN  INHIBITED 


Figure  8-2  (Cont’d) 
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^SPECIAL  PROCESSOR  (IF  SET, 
LOWER  15  BITS  CONTAIN  OFFSET 
INTO  SPECIAL  PROCESS  TABLE) 
**IF  SET,  OPERATOR  CHANGEABLE 
***IF  SET,  NOT  OPERATOR  CHANGE- 
ABLE, OUTPUT  ONLY 
****BECOMES  OFFSET  INTO  SPATBL 
WHEN  FUNCTION  CODE  2 AND  3 
USED 


Figure  8-3  VT05  Input  Parameter  Linkage  Tables 
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Figure  8-3  (Cont'd) 
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general  registers  and  processor  stack  be  set  up  by  the  DOS 
EMT  handler.  Inputs  to  CCTH  are  in  a parameter  block  which 
is  defined  in  figure  8-4.  Output  from  the  handler  is  in  the 
status  byte  of  the  PBA,  as  shown  in  the  same  figure.  Also 
saved  is  the  address  of  the  parameter  block  for  the  current 
operation.  CCTH  is  divided  into  an  initialization  port  ion 
and  an  interrupt  service  portion.  The  initialization  por- 
tion is  called  through  the  EMT  handler;  it’ selects  the 
units,  initializes  the  operation,  and  enables  the  done 
interrupt.  The  interrupt  service  portion  is  called  for 
the  done  interrupt  through  the  9-track  interrupt  vector; 
it  checks  for  all  possible  conditions  which  could  have  oc- 
curred during  execution  of  the  operation,  and  reports  the 
status  back  to  the  user  program  in  the  status  byte  of  the 
parameter  block.  The  calling  program  calls  CCTH  by  pushing 
a PBA  onto  the  processor  stack  and  then  executing  an  EMT 
instruction  which  contains  an  identifier  associated  with 
CCTH.  For  SEDS  the  EMT  identifier  for  CCTH  and  communica- 
tion for  tape  units  on  controller  No.  1 is  140.  The  calling 
sequence  is  as  follows : 


MOV  #PBA,-(SP) 
EMT  140 


F CCTH2.  This  is  a 9-track  tape  handler  identical  to  CCTH 
except  that  tape  communication  is  established  for  tape 
units  on  controller  No.  2.  The  SEDS  EMT  identifier  is 
145.  The  interrupt  portion  of  CCTH2  (CCTNT2)  is  entered 
from  the  interrupt  vector  when  the  done  interrupt  is  to  be 
serviced  from  tape  controller  No.  2.  For  SEDS,  the  EMT 
identifier  for  CCTH2  for  tape  units  on  controller  No.  2 is 
145.  The  calling  sequence  is  as  follows: 


MOV  #PBA2 ,- (SP) 
EMT  145 


G.  IDEH.  This  is  the  imagery  display  equipment  handler  for 
SEDS . It  provides  the  interface  between  the  display  con- 
troller and  SEDS  user  programs,  and  provides  for  interrupt 
servicing  and  status  posting  for  the  controller.  The  ini- 
tialization portion  of  IDEH  is  entered  through  the  DOS  EMI 
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tl  14  IS  12  1 1 10  • • 7 6 3 4 3 2 1 0 

PBA 

+ 2 
+4 

*IF  SET,  REQUEST  IS  FOR  STATUS  CONDITION  ONLY 


f—l 1 1 j ! 1 

— i — 

— , — 

— i — i — 

— 

STATUS 

UNIT 

MEX 

FUNC 

* 

BUFFER  ADDRESS 


WORD  COUNT 

J I I I I |,  1 i 1 1 1 t 1.  .1  -JL 


FUNCTION  (BITS  1-3): 

0 = OFFLINE 

1 = READ 

2 = WRITE 

3 = WRITE  EOF 

4 = FORWARD  SPACE  RECORDS  (COUNT  IN  PBA+4) 

5 = REVERSE  SPACE  RECORDS  (COUNT  IN  PBA+4) 

6 = WRITE  EXTENDED  GAP 

7 = REWIND 

MEX  (BITS  4,5): 

EXTENDED  ADDRESS  BITS  17  and  18 
UNIT  (BITS  6,7): 

0 = UNIT  0 

1 - UNIT  1 

STATUS  (BITS  8-15,  SET  FOR  CONDITION): 

8 = DRIVE  NOT  READY 

9 = PARITY  ERROR 

10  = END-OF-FILE 

11  = END-OF-TAPE 

12  = BEGINNING  OF  TAPE 
13=  DEVICE  FAILURE 

14  = TAPE  UNIT 

15  = OPERATION  NOT  COMPLETE  (BUSY) 


Figure  8-4  Magnetic  Tape  Drive  Parameter  Block 
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handler  at  the  address  specified  in  the  monitor  residency 
table,  MRT . The  interrupt  service  portion  of  the  handier, 
HDINT * is  entered  through  the  interrupt  vector  when  any  one 
of  the  three  interrupts  occur.  The  program  calling  IDEH 
fin  SEDS  applications  programs,  the  routine  is  called  D J 
does  so  by  pushing  a PBA  onto  the  processor  stack  and  then 
executing  an  EMT  instruction  which  contains  an  identifier 
associated  with  IDEH.  For  SEDS,  this  identifier  is  141. 

The  calling  sequence  is  as  follows: 


MOV  #PBA, - (SP) 
EMT  141 


Control  is  returned  by  the  handler  at  the  instruction 
following  the  EMT.  The  user  program  must  check  the  busy 
flag  before  calling  IDEH  again  for  a display  function,  to 
ensure  that  the  device  is  not  busy.  Figure  8-5^  shows  in 
detail  the  display  parameter  block  for  IDEH. 


8.2.2  Flow  Charts.  See  the  55  pages  following  figure  8-5 
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I DP  BA  (STATUS) 
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CONTROL- 

STATUS 


V. 
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UNITS 
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CONTROL  PANEL  REGISTER  (BCD) 


Used  only  to  return  status  to  the  user  program. 

Bit  15  - If  set,  indicates  that  format  of  displayed  image  is  selected 

from  display  operator's  control  panel;  if  cleared,  indicates 
that  format  control  is  being  selected  by  software. 

Bits  7-0  - Two  BCD  digits  dialed  in  at  the  panel  with  values  of  00-99; 
used  for  options  and  controlled  by  the  operator, 

IDPBA  + 2 (FORMAT  AND  COMMAND) 


Bit  15  - If  set,  the  computer  control  command  must  be  executed  before  the 
format  can  be  software-selected. 

Bits  14-10  instruct  the  handler  to  select  the  specified  display  format. 

Bit  14  - If  set,  refresh  data  is  displayed  with  color  assignments  following; 
(LSB  & MSB)  Bits  2 and  3 = blue;  Bits  4 and  5 = green;  Bits  6 and 
7 = red.  This  bit  may  not  be  used  with  enhance  selected  (see  bit 
13). 

Bit  13  - If  set,  data  will  be  modified  by  contents  of  enhancement  look-up 
tables  before  being  displayed. 


Figure  8-5  Imagery  Display  Parameter  Block  (IDPBA) 
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Bit  12  - If  set,  a gray  scale  or  color  bar  will  be  displayed  across  lower 
48  lines  of  displayed  image. 

Bit  11  - If  set,  area  bracketed  by  the  cursor  will  be  magnified  to  fill 
the  screen. 

Bit  10  - If  set,  pixel  value  will  be  converted  to  an  alphanumeric  char- 
acter and  displayed. 


Bits  7-0  command  the  display  handler  to  initiate  the  described  action. 
Bit  7 


This  command  executes  in  a single  call  a reset  arid  clear  on  the 
display  and  positions  the  cursor  at  the  home  position 


register  value  and  X-Y  cursor  position. 

Bit  5 - Reverts  display  format  control  to  the  user  software. 

Bit  4 - Initializes  display  logic  that  keeps  count  of  even/odd  scans  for 
automatic  scrolling. 

Bit  3 - Erases  the  refresh  memory. 

BU  2 - scroll S|tiode  below), 

the  image  will  scroll  automatically  after  every  other  GO. 

Bit  1 - Signifies  the  completion  of  a scan  line  that  has  been  constructed 

one  color  at  a time. 

Bit  0 - Indicates  a message  transfer. 

IDPBA  + 4 (INPUT  PARAMETERS) 
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Expands  on  the  type  of  data  transfer  that  is  to  take  place,  specifies  the 
purpose  of  the  data  and  identifies  the  mode  of  operation  of  the  display. 

Bit  15  - Specifies  that  this  message  transfer  is  to  one  of  three 

enhancement  tables  (one  for  each  color).  Desired  table  is 
selected  by  bits  13  and  12.  The  format  of  data  for  enhance- 
ment table  must  be  specific,  with  the  upper  byte  containing 
the  address  in  the  table  to  receive  the  data  and  the  lower 
byte  containing  the  data  value  itself.  This  is  accomplished 
by  setting  bit  12  in  the  Format  and  Command  Word  and  reading 
a scan  line  from  the  color  bar  which  is  displayed. 

Bit  14  - Specifies  that  this  message  transfer  is  from  the  display 

memory  addressed  by  line  and  segment. 

Bits  13-12  - In  combination,  these  color  tag  each  message  to  or  from  the 

display  unit  as  follows:  0-1  = red  with  LSB/MSB  6/7;  1-0  = 

green  with  LSB/MSB  4/5;  1-1  = blue  with  LSB/MSB  2/3;  0-0  = 
black  and  white  (all  6 bits)  with  LSB/MSB  2/7. 

Bit  11  - If  set,  displayed  image  will  move  up  by  two  scan  lines  when 

a scroll  command  or  condition  occurs;  if  cleared,  image  will 
move  down. 

Bit  10  - If  set,  causes  update  message  to  be  displayed  left-to-right; 

if  cleared,  data  will  be  displayed  right-to-left. 

Bit  9 - Allows  display  unit  to  trap  data  from  the  UNIBUS  for  screen- 

ing; only  one  call  to  IDEH  is  required  to  display  an  image 
in  this  mode.  UNIBUS  is  monitored  by  the  display  hardware 
for  the  final  word  address  (IDPBA  + 10),  then  begins  trap- 
ping data  for  subsequent  addresses  until  the  message  length 
(IDPBA  + 12)  is  satisfied.  When  it  is,  the  display  again 
monitors  UNIBUS  for  final  word  address.  If  SCROLL  MODE  is 
selected,  image  will  scroll  in  the  desired  direction  after 
every  other  scan. 

Bit  8 - Causes  display  unit  to  discard  high  order  byte  of  each 

update  message  transfer. 

Bit  7 - Allows  display  to  scroll  after  every  other  message  transfer 

to  the  display;  i.e.,  after  every  other  GO. 

Bit  6 - Permits  display  unit  to  generate  interrupts. 

Bit  5 - Specifies  that  associated  message  transfer  is  to  a random 

line  and/or  segment  on  the  display;  bit  is  required  to  keep, 
the  update  from  affecting  the  scroll  and  compression  logic. 


Figure  8-5  (cont'd.) 


JSC-10019 
Part  II 


Bit  4 - In  this  call  only,  positions  the  cursor  to  the  point  spec- 

ified by  the  X and  Y positions  passed  in  the  parameter  block, 
I DP BA  14  and  16. 

Bits  3-0  - Applied  to  every  data  mes$aq£  sent  to  the  display  unit;  first 

pixel  will  be  the  C th  byte  and  every  C th  byte  following  the 
first  displayed  pixel. 

I DP BA  + 6 (READ/WRITE  LINE  AND  SEGMENT) 
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LINE  NUMBER  SEGMENT  NUMBER 


Allows  user  to  address  display  image  as  to  where  a message  is  output  to  or 
recalled  from  (see  figure  3-  ). 

Bits  15-6  - Specify  image  line  number  to  be  updated  or  recalled.  For 
scrolling  bottom  to  top,  use  line  = 0;  for  scrolling  top  to 
bottom,  use  line  =429. 

Bits  5-0  - Specify  image  starting  segment  number  to  be  updated  or  recalled 

from.  Each  line  is  divided  into  19  segments  of  32  pixels  each, 
with  only  18  segments  visible.  The  19th  scan  line  in  blanking 
can  be  updated  and  recalled,  so  that  it  can  be  used  for  such 
things  as  scan  line  identification. 

IDPBA  + 10  (FIRST  WORD  ADDRESS) 
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Specifies  the  16  least  significant  bits  of  the  update  or  recall  buffer  start 
address. 

IDPBA  + 12  (MEMORY  EXTENSION  BITS  AND  MESSAGE  LENGTH) 
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I 

Bits  15-14  - Specify  the  two  most  significant  bits  of  the  update  or 

recall  buffer  First  Word  Address  (see  above).  These  bits 
allow  buffer  addresses  of  18  bits. 

Bits  13-0  - Specify  the  number  of  16-bit  word  transfers  in  the  update 
or  recall  message. 


I DP BA  + 14  (X-POSITION) 


Specifies  the  binary  count  horizontal  location  of  the  center  of  the  cursor 
with  respect  to  the  displayed  image  (see  figure  2-2).  Home  position  = VI 40 
(608^q).  The  cursor  is  two  segments  (64  pixels)  wide. 

IDPBA  + 16  (Y-POSITION) 


Specifies  the  binary  count  vertical  location  of  the  center  of  the  cursor 
with  respect  to  the  displayed  image  (see  figure  2-2).  Home  position  = 030 
(24-jq).  The  cursor  is  48  lines  high. 


) 


Figure  8-5  (cont'd.) 
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SECTION  9 

SUPPORT  AND  UTILITY  SOFTWARE 


9.1  GENERAL  SUPPORT  AND  UTILITY  SOFTWARE  CHARACTERISTICS 

The  SEDS  software  package  contains  various  DEC  support  and  utility 
programs  as  well  as  some  previously  developed  by  SISO,  The  special 
support  software  implemented  for  SEDS  will  be  covered  in  this 
section.  Refer  to  PHO-TR545,  paragraph  3.7,  for  explanations  of 
other  support  and  utility  software. 

9.2  CPC  CHARACTERISTICS 
9.2.1  Component  Descriptions 

A.  DLOGIT.  This  is  an  independent  program, that  will  delog 
both  the  SEDS  SBC  (update)  and  OBC  (data  base)  tapes  in 
easily  readable  format  on  the  line  printer.  The  program 
allows  the  User  to  select  the  data  channel  desired,  the 
start  and  stop  scan  line  numbers,  and  the  start  and  stop 
PIXEL  numbers.  This  control  is  accomplished  through  cards 
input  via  the  card  reader.  There  must  be  one  data  card 
for  each  data  channel,  or  part  of  a channel,  to  be  delogged. 
Also,  the  start  scan  line  number  must  be  less  than  or  equal 
to  the  stop  scan  line  number,  and  the  same  is  true  for  the 
start  and  stop  PIXEL  parameters.  Figure  9-1  shows  a 
sample  card  deck  for  the  execution  of  DLOGIT. 

1.  Channel  Selection.  Depending  on  the  kind  of  tape, 
one  of  the  following  number  codes  in  column  5 of 
the  data  card  should  be  punched  to  select  the  desired 
channel: 


a.  Update  (SBC)  Tape 
• 1 = New  CMI 


• 2 = New  DMAT 
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TO  INITIATE  THE  JOB,  THE  FOLLOWING  JOB  CARD  DECK  SHOULD 
BE  INPUT  IN  THE  CARD  READER  CONTAINING  THE  DATA  CARDS. 


ON  THE  DECWRITER,  KEY  IN  BA  CR:,  LP:  <CR>  TO  READ  THE 
JOB  CARD  DECK  AND  BEGIN  THE  TAPE  DELOG  PROGRAM. 


Figure  9-1  D LOG IT  Exection  Deck 
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• i 3 = Old  CM I 

• 4 = old  DMAT  ! 

b.  Data  Base  (OBC)  Tape 

• 1 = STMAT 

. ' C i 

• 2 =!  LTMAT 

• 3 = LTMCMI 

• 4 =|  DDSUM 

• 5 = NGOOD 

• 6 = STQUAL 

2.  Scan  Line  Selection.  To  select  the  start  and  stop  scan 
line  numbers,  the  user  should  punch  the  start  scan  num- 
ber, right- justified,  in  columns  6-10,  and  punch  the 
stop  scan  number,  right- justified,  in  columns  11-15 

of  the  data  card.  From  one  to  550  scan  lines  may  be 
delogged  for  each  data  channel  selected. 

3.  PIXEL  Number  Selection.  The  start  and  stop  PIXEL  num- 
bers  are  entered  by  punching  the  start  PIXEL  number, 
right- j ust if ied,  in  columns  21-25  of  the  data  card. 

The  range  of  PIXELS  for  each  scan  line  is  1 to  625. 

DIJMPIT.  This  is  a program  that  will  dump  six  kinds  of 
data  located  in  three  separate  disk  fifes  in  SEDS.  The 
SEDS  registered  data  is  in  a disk  file  named  SEDREG.DAT, 
which  contains  three  types  of  data:  night  IR,  day  IR, 

and  day  visible.  Header  information  about  this  data  is 
contained  in  the  disk  file  SEDREG.HDR.  The  delta  T (AT) 
data  file  may  be  delogged  and  is  in  the  disk  file 
SEDDLT .DAT.  The  SEDS  ground  truth  zone  map  (GTZONE)  and 
altitude  map  (ALT)  is  delogged  from  a disk  file  named 
SEDGRD.DAT.  The  registered  data  will  be  preceded  by  a 
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dump  of  the  header  record.  The  data  from  all  files  will 
be  output  to  the  line  printer.  The  program  allows  tl e 
user  to  specify  the  data  type  and  the  start  and  stop 
record  number  for  each  dump  desired.  Two  cards  are 
nuired  for  each  dump.  More  than  one  dump  may  be  done 
each  run  by  adding  the  appropriate  data  cards. 

1 Data  Type.  To  specify  the  data  type,  the  user  should _ 
punch  one  of  the  following  number  codes  m column  5 of 

card  1. 

1 = Night  IR 

2 = Day  IR 

• 3 = Day  visible 

• 4 = AT 

• 5 = ALT 


• 6 = GTZONE 

2 Records  for  Output.  To  specify  the  records  for  output 
a start  record  number  is  required.  There  are  four 
scan  lines  to  each  record;  therefore,  record  No.  1 con 
tains  scan,  lines  1-4;  record  No.  2 contains  scan  1 in 
5-8  etc.  The  user  should  punch  the  start  record  num- 
ber! right- justified,  in  columns  1-5  of  card  2,  and 
punch  the  stop  record  number,  right- justified,  in- 
columns  15-20  of  card  2. 

V Ranee  of  Records.  The  range  of  1 to  139  records  may v 
be  dumped  for  each  data  type.  Also,  the  start  record 
number  must  be  less  than  or  equal  to  the  stop  record 
number.  Figure  9-2  shows  a sample  execution  run. 

MERGE.  This  is  an  offline  program  to  merge  the  SEDS  data 
bTiT’tapes.  In  the  current  SEDS  day-to-day  production 
cycle,one  new  tape  (reel)  is  required  each  day  for  data 
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TO  DUMP  RECORDS  17-95  OF  NIGHT  IR,  RECORDS  87-130  OF  DAY  IR, 
RECORDS  101-127  OF  NIGHT  IR,  AND  RECORDS  1-139  OF  DAY  VIS,  THE 
FOLLOWING  DATA  CARD  SETUP  WOULD  BE  REQUIRED: 


TO  INITIATE  THE  JOB,  THE  FOLLOWING  JOB  CARD  DECK  SHOULD  BE  INPUT 
IN  THE  CARD  READER  CONTAINING  THE  DATA  CARDS  MENTIONED  ABOVE: 


ON  THE  DECWRITER,  KEY  IN  BA  CR:,LP:<CR>  TO  READ  THE  JOB  CARD  DECK 
IN  AND  TO  BEGIN  THE  DUMP  PROGRAM 


Figure  9-2  DUMPIT  Execution  Deck 
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base  maintenance.  MERGE  will  allow  up  to  seven  tapes  to 
be  put  onto  one  tape  reel.  The  data  base  data  remains 
unchanged  except  that  7 day's  worth  of  SEDS  processing 
will  be  catalogued  onto  a single  tape  reel.  Each  pro- 
cessing run  is  separated  by  two  end-of-file  marks  except 
for  the  last  file,  which  is  followed  by  three  end-of- 
file  marks.  Figure  9-3  shows  the  method  used  in  the  tape 

merge. 


EPPRbc.  This  program  has  two  functions,  each  using  card 
input  ephemeris  data.  The  first  data  card  contains  the 
date  the  program  is  being  run  and  the  satellite  number, 
with  the  format  MMbDDbYY  bbbbbbbX,  where  X is  the  satel- 
lite number  (i.e.  , 4 for  NOAA-4)  . The  subsequent  cards, 
one  card  for  each  orbit,  contain  the  following  information 
day  or  night  (punch  D or  N in  column  1) , the  orbit  number, 
Julian  day,  hour  and  minute  of  equator  crossing,  altitude, 
and  longitude  of  equator  crossing,  in  the  format  shown 

below, 

(A2,7X,I6,4X,I4,6X,I2,8X,F5.2,5X,F7.2,3X,F7.2) 

The  last  data  card  will  be  an  end  card  with  E punched  in 
column  1.  The  program  lists  the  input  cards  on  the  line 
printer  for  ease  of  verification.  One  of  the  two  primary 
outputs  is  a tabulation  of  the  calculated  tape  start  and 
stop  time,  and  start  and  stop  PIXEL  number  to  be  used  m 
editing  the  preprocessor  tape.  The  second  primary  output 
is  a tabulation  of  predicted  registration  coefficients 
(A2,  B'2 , A3,  and  B3)  to  be  used  in  registration  when 
there  are  too  few  ground  control  points  visible  for 
accurate  registration.  For  each  orbit,  the  record  of  the 
Julian  date,  orbit,  night  or  day,  longitude  and  time  of 
equator  crossing,  altitude,  tape  start  and  stop  times, 
and  tape  start  and  stop  PIXELS,  is  written  on  the  scratch 
disk.  This  disk  file  is  transferred  to  the  production 
disk  with  the  program  EPTRAN.  To  run  the  program,  the 
user  sets  up  a batch  card  deck  as  shown  on  page  9-8. 


ETIPRODlJCIBILI'fY  OF 
ORDINAL  FAGS  IS  POOR 
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Figure  9-3  Multifile  Data  Base  Tapes  Using  Merge 
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ORBIT  DATA  CARDS 
( DATE  CARD 
$RUN  EPPROC 


^ $AS 


( $EOD  

[/$Ar  DKO:NOAA4.TMPU50,15Q!  ,13 


DKO  :NOAA3.  TMP 4:150 , 150  ! ,13 


^ $JOB  EPPROC41 50 ,150 


EPTRAN.  This  program  has  only  one  function;  to  take  the 
disk  file  written  by  EPPROC  onto  the  scratch  disk  (DK1) 
and  transfer  it  to  the  production  disk  (DKO) . See  item 
D above.  The  program  is  controlled  by  operator  inputs 
through  the  DECwriter,  in  response  to  messages  typed  by 
the  program  on  the  DECwriter.  To  run  the  program,  the 
user  sets  up  a batch  card  deck  as  shown  below. 


^ $pI  — 

|<  $RUN  EPTRAN 

( $E0D  ” 


£! 


AS  N0AA4 . PRM, 16 


$AS  NOAA4 .TEMP , 15 


JOB  EPTRAN 4 150,1 50 ! 


SEDSUM.  This  Data  Base  Delog  Program  allows  the^calcula- 
tion  of  the  averages  of  the  values  for  the  five  SEDS  data 
base  channels  over  irregularly  shaped  geographic  areas  o 
the  SEDS  reference  grid.  Each  of  these  geographic  areas 
is  defined  by  card  inputs  of  the  following  format. 
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Area  ID  (1-256) 
fScan  Line  Number  (1-500) 

< Start  PIXEL  Number  (1-625) 
LStop  PIXEL  Number  (1-625) 


Nth 

Set 


{ 


• ' 

Scan  Line  Number 
Start  PIXEL  Number 
Stop  PIXEL  Number 
Blanks  (End  of  Area) . 


: : j 

As  many  cards  as  necessary  may  be  used  to  define  an  area, 
with  six  sets  of  scan  line,  start  PIXEL  and  stop  PIXEL 
numbers  defined  per  Card.)  All  cards  with  the  same  area 
ID  are  processed  together  as  a single  unit.  A restriction 
on  the  maximum  size  of  these  areas  is  that  each  area  must 
be  completely  included  within  either  scan  lines  1-300  or 
scan  lines  200-500,  without  overlapping.  The  lower  50 
scan  lines  of  the  latter  group  are  all  over  the  Pacific 
Ocean.  The  following  10  parameters  are  compiled  and 
printed  out  for  each  area  defined. 

•|  Average  STMAT  (°C) 


• Average  ST  growth  potential 

• Average  LTMAT  (°C) 

• Average  LT  growth  potential 

• Average  LTMCMI  (CMI  units) 

• Average  CMI  growth  potential 

• Average  pupation  time  (days) 


• Average  DDSUM  growth  potential 
•j Average  NGOOD/N  (fraction,  0-1) 
•Combined  average  growth  potentials 
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The  first  300  scan  lines  of  data  from  the  s<  • acted  data 
base  tape  are  read  and  placed  on  a scratch  disk,  and  then 
each  of  the  areas  in  the  first  group  is  processed  to  com- 
pletion via  separate  passes  through  the  data  from  disk. 
Lines  200  to  500  of  the  image  are  then  read  onto  the  disk, 
and  the  second  group  of  areas  are  processed  one  at  a time. 


1.  SEDSUM  Calculations.  If  m is  the  total  number  of  PIXELS 
■(T)  defined  in  a given  area  ID,  each  of  the  10  averages 
is  calculated  as  follows. 

a.  Average  STMAT  (°C) 

m i 

ST  = i 

1=1  1 

b.  Average  ST  Growth  Potential 


m 

g7  - i X)  GP . (ST  Temp  . 
1 m t— ? i i 

i=l 

c .  Average  LTMAT  (°C) 


LT  = i || LTMAT  1(-Dt  Basej  N*4.o]  - 1 3 . 1 6 1 
where : 

N = Data  base  length  in  days 

LTMAT values  = running  N-day  scans 

d.  Average  LT  Growth  Potential 

s,  = I Zj  GPiCLT  Temp.) 

2 m r— f l i 

i=l 
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e.  Average ■ LTMCI  (in  CMI  Units) 

(D.  Base) 


m 


r.iE 

2 m i=l 
where : 


LTMCMI 


N 


-128.0 


16.0 


LTMCMI ^ase^ values  = encoded  running  N-day 


sums 


£.  Average  CMI  Growth  Potential 


m 

gT  = - GP . 
3 m £l  1 


(LTMCMI . ) 


g.  Average  P'upation  Time  (Days) 


m 

.i£ 


MPT  = - /*  MPT . 
m i=l  1 


where : 


MPT^  (mean  pupation  time  for  1th  day) 

= 60  days  if  DDSUM^  £ N*2. 318333  + 0.5,  or 


MPTi  = N*556.4/DDSUMi 


h . Average  DDSUM  Growth  Potential 
mi 


G,  = i A G P.  (MPT/ 
4 m 4--f  l v i- 
i=l 


1.  Average  NGOOD/N  (Fraction,  0-1) 


m 

NG  - i £ NG00Di 
m . / M 
i=l  N 
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j . Combined  Average  Growth  Potential  (GJ 

G = GXC1  G2C2  G3C3  G4C4  (C1+C2+C3+C4  = 1) 
where: 

Cl,  C2 , C3 , and  C4  = card  input  combination 
coefficients;  Gi,  G2,  G3  and  G4  = four  average 
growth  potentials  as  calculated  above. 

The  three_growth  potential  tables  used  in  calcula- 
ting Gi,  G2,  G3,  and  G4  above  are  the  same  tables 
used  in  generating  the  five  color-coded  growth 
potential  images  in  SEDS  Data  Base  Update  Sequence 
No,  2.  The  8-bit  encoded  values  (S-^)  used  for  SEDS 
products  are  related  to  growth  potentials  (G^)  as 
follows: 

S.  = Integer  (100  In  G^  + 128.5) 

The  combination  algorithm  is: 

S = C1*C  + C2*G2  + C3*G3  + C4*G4 

It  can  be  easily  shown  that  this  form  of  the  com- 
bination algorithm  is  mathmatically  equivalent  to 
the  form  used  above  as  long  as  Cl  + C2  + C3  + C4  = 

1.0. 

For  any  discussion  of  numerical  analysis  or  the  validity 
. of  mathematical  calculation,  contact  J , A.  Boatright 
of  Aeronutronic  Ford  Corporation. 

Operation  Procedure.  SEDSUM  is  a standalone  tape  delog 
program  that  uses  the  SEDS  data  base  tape  as  an  input 
tape.  SEDSUM  outputs  two  products,  an  online  tabula- 
tion and  a 9 -track  tape  of  data  averaged  from  each 
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active  channel  in  the  data  base,  along  with  the  average 
of  the  corresponding  growth  potential  for  each  channel. 
The  following  hardware  configuration  is  required  for 
operation  of  the  SEDSUM  program. 

• DKO  - SEDSPR2  production  disk 

• DK1  - Scratch  disk  with  at  least  3575  contiguous 
free  blocks  of  core  space 

• MTX  - One  magnetic  tape  unit  assigned  to  logical 
unit  9 (input) 


MTX  - One  magnetic  tape 
unit  10  (output) 


KB 


- DECwriter  keyboard 


CR  - Card  reader 


unit  assigned  to  logical 


LP  - Line  printer 
sample  run  deck  is  as  shown: 


$ JOB  NAME  [210,50] 

$AS  MT1 : ,9 
$AS  MTO : ,10 
$RU  SEDSUM.  1/DA 

...  ' • 

DATA  CARDS 

■ ■■  ■ y 

$FI 

Table  9-1  gives  a lead  card  setup  for  SEDSUM. 

Table  9-2  gives  a cross-reference  of  sector  number  and  county 
name.  - :- 

Figure  9-4  shows  a record  layout  of  the  output  9 - track  tape* 


9-13 


JSC-10019 
Part  II 


TABLE  9-1 

LEAD  CARD  SETUP  FOR  SEDSUM 


CARD 

TYPE 

MNEMONIC 

COLUMNS 

FORMAT 

RANGE 

DESCRIPTION 

1 

IFILE 

1-5 

15 

1-32767 

REQUESTED  FILE  NO.  OF 
INPUT  TAPE 

2* 

I SECT 

1-3 

13 

I- 254 

SECTOR  NO. 

ISCAN  (1) 

5-7 

13 

1 - v2  7 5 

SCAN  LINE  NO, 

ISRT  (1) 

9-11 

13 

1-  625 

START  PIXEL  NO. 

ISTP  (1) 

13-15 

13 

1-625 

STOP  PIXEL  NO. 

ISCAN  (2) 

17-19 

13 

1-275 

SCAN  LINE  NO. 

ISRT  (2) 

21-23 

13 

1-625 

START  PIXEL  NO. 

ISTP  (2) 

25-27 

13 

1-625 

STOP  PIXEL  NO. 

ISCAN  (3) 

29-31 

13 

1-275 

SCAN  LINE  NO. 

ISRT  (3) 

33-35 

13 

1-625 

START  PIXEL  NO. 

ISTP  (3) 

37-39 

13 

1-625 

STOP  PIXEL  NO. 

ISCAN  (4) 

41-43 

13 

1-275 

SCAN  LINE  NO. 

• : 

ISRT  (4) 

45-47 

13 

1-  625 

START  PIXEL  NO. 

ISTP  (4) 

49-51 

13 

1-625 

STOP  PIXEL  NO. 

ISCAN  (5) 

53-55 

13 

1-275 

SCAN  LINE  NO. 

ISRT  (5) 

57-59 

13 

1-  625 

START  PIXEL  NO. 

ISTP  (5) 

61-63 

13 

1-625 

STOP  PIXEL  NO. 

ISCAN  (6) 

65-67 

13 

1-275 

SCAN  LINE  NO. 

*■ 

ISRT  (6) 

69-71 

13 

1-  625 

START  PIXEL  NO. 

ISTP  (6) 

J 

73-75 

13 

1-625 

STOP  PIXEL  NO. 

*PARn  TYPE  2 IS  REPEATED  FOR  EACH  SECTOR  IN  A GIVEN  RUN.  THE  MAXIMUM  NUMBER 
$RSE™ V PIXELS  REQUESTED  PER  SECTOR  IS  50;  A SET  OF  PIXEL  REQUESTS  INCLUDES 
A SCAN  LINE  NUMBER,  START  PIXEL  NUMBER,  AND  STOP  PIXEL  NUMBER.  THE  END  OF 
A SECTOR  IS  DENOTED  BY  A BLANK  OR  ZERO  VALUE  FOR  THE  SCAN  LINE  NUMBER  OR  A 
SECTOR  NUMBER  DIFFERENT  FROM  THE  PREVIOUS  SECTOR  NUMBER  READ.  THERE  IS  NO 
LIMIT  TO  THE  MAXIMUM  NUMBER  OF  SECTORS  THAT  CAN  BE  PROCESSED  IN  A GIVEN  RUN. 
DATA  CARDS  WILL  BE  SUPPLIED  BY  LOCKHEED  CORPORATION. 
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NO. 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 


TABLE  9-2 

GROSS  REFERENCE  OF  SECTOR  NUMBERS  AND  COUNTY  NAMES 

\ 


COUNTY 


ANDERSON 

ANDREWS 

ANGELINA 

ARANSAS 

ARCHER 

ARMSTRONG 

ATASCOSA 

AUSTIN 

BAILEY 

BANDERA 

BASTROP 

BAYLOR 

BEE 

BELL 

BEXAR 

BLANCO 

BORDEN 

BOSQUE 

BOWIE 

BRAZORIA 

BRAZOS 

BREWSTER 

BRISCOE 

BROOKS 

BROWN 

BURLESON 

BURNET 

CALDWELL 

CALHOUN 

CALLAHAN 

CAMERON 

CAMP 

CARSON 

CASS 

CAStRO 

CHAMBERS 

CHEROKEE 

CHILDRESS 

CLAY 

COCHRAN 

COKE 

COLEMAN 

COLLIN 


NO. 

COUNTY 

44 

COLLINGSWORTH 

45  ! 

COLORADO 

46 

COMAL 

47 

COMANCHE 

48 

CONCHO 

49 

COOKE 

50 

CORYELL 

51 

COTTLE 

52 

CRANE 

53 

CROCKETT 

54 

CROSBY 

55 

CULBERSON 

56 

DALLAM 

57 

DALLAS 

58 

DAWSON 

59 

DEAF  SMITH  j 

60 

DELTA 

61 

DENTON 

62 

DE  WITT 

63 

DICKENS 

64 

DIMMIT 

65 

DONLEY 

66 

DUVAL 

67 

EASTLAND 

68 

ECTOR 

69 

EDWARDS 

70 

ELLIS 

71 

EL  PASO 

72 

ERATH 

73 

FALLS 

74 

FANNIN 

75 

FAYETTE 

76 

FISHER 

77 

FLOYD 

78 

FOARD 

79 

FORT  BEND 

80 

FRANKLIN 

81 

FREESTONE 

82 

FRIO 

83 

GAINES 

84 

GALVESTON 

85 

GARZA 

86 

GILLESPIE 
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TABLE  9-2  (CONT'D) 


NO. 

COUNTY 

87 

GLASSCOCK 

88 

GOLIAD 

89 

GONZALES  J 

90 

GRAY 

91 

GRAYSON 

92 

GREGG 

93 

GRIMES 

94 

GUADALUPE 

95 

HALE 

96 

HALL  i 

97 

HAMILTON 

98 

HANSFORD 

99 

HARDEMAN 

100 

HARDIN 

101 

HARRIS 

102 

HARRISON 

103 

HARTLEY 

104 

HASKELL 

105 

HAYS 

106 

HEMPHILL 

107 

HENDERSON 

108 

HIDALGO 

109 

HILL 

110 

HOCKLEY 

111 

HOOD 

112 

HOPKINS 

113 

HOUSTON 

114 

HOWARD 

115 

HUDSPETH 

116 

HUNT 

117 

HUTCHINSON 

118 

IRION 

119 

JACK 

120 

JACKSON 

121 

t JASPER 

122 

JEFF  DAVIS 

123 

, JEFFERSON 

124  * 

JIM  HOGG 

125 

J JIM  WELLS 

126 

JOHNSON 

127 

JONES 

128 

KARNES 

129 

KAUFMAN 

NO. 

COUNT 

130 

KENDALL 

131 

KENEDY1 

132 

KENT 

133 

KERR 

134 

KIMBLE 

135 

KING 

136 

KINKEY 

137 

KLEBERG 

138 

KNOX 

139 

LAMAR 

140 

LAMP 

141 

LAMPASAS 

142 

LA  SALLE 

143 

LAVACA 

144 

LEE 

145 

LEON 

146 

LIBERTY 

147 

LIMESTONE 

148 

LIPSCOMB 

149 

LIVE  OAK 

150 

LLANO 

151 

LOVING 

152 

LUBBOCK 

153 

LYNN 

154 

MCCULLOCH 

155 

MCLENNAN 

156 

MCMULLEN 

157 

MADISON 

158 

MARION 

159 

MARTIN 

160 

MASON 

161 

MATAGORDA 

162 

MAVERICK 

163 

MEDINA 

164 

MENARD 

165 

MIDLAND 

166 

MILAM 

167 

MILLS 

168 

MITCHELL 

169 

MONTAGUE 

170 

MONTGOMERY 

171 

MOORE 
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MORRIS 

MOTLEY 

NACOGDOCHES 

NAVARRO 

NEWTON 

NOLAN 

NUECES 

OCHILTREE 

OLDHAM 

ORANGE 

PALO  PINTO 

PANOLA 

PARKER 


POTTER 

PRESIDIO 

RAINS 

RANDALL 

REAGAN 

REAL 

RED  RIVER 

REEVES 

REFUGIO 

ROBERTS 

ROBERTSON 

ROCKWALL 

RUNNELS 

RUSK 

SABINE 

SAN  AUGUSTINE 
SAN  JACINTO 
SAN  PATRICIO 
SAN  SABA 
SCHLEICHER 
SCURRY 

SCHACKELFORD 

SHELBY 

SHERMAN 

SMITH 

SOMERVELL 


STARR 

STEPHENS  i 

STERLING 

STONEWALL 

SUTTON 

SWISHER 

TARRANT 

TAYLOR 

TERRELL 

TERRY 

THROCKMORTON 

TITUS 

TOM  GREEN 

TRAVIS 

TRINITY 

TYLER 

UPSHUR 

UPTON 

UVALDE 

VAL  VERDE 

VAN  ZANDT 

VICTORIA 

WALKER 

WALLER 

WARD 

WASHINGTON 

WEBB 

WHARTON 

WHEELER 

W'ICHITA 

WILBARGER 

WILLACY 

WILLIAMSON 

WILSON 

WINKLER 

WISE 

WOOD 

YOAKUM 

YOUNG 

ZAPATA 

ZAVALA 
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0 


1 
2 

3 

4 

5 

6 

7 

8 
9 

10 
11 
12 

13 

14 

15 

• DATA  BASE  UPDATE  TAPE  (SEQ.  NO.  1 - RAP) 

• DATA  BASE  TAPES  (SEQ.  NO.  2 - SSP) 


Figure  9-4  Layout  of  Output 
9-Track  Tape 


B 

S 

NOT  USED 

C 

2 

1 

4 

3 

6 

5 

NO.  OP  CHANNELS 

1 2 3 4 5 

MONTH 

DAY 

NOT  USED 

YEAR (LAST  2 DIGITS) 

DATA  BASE  LENGTH  (N) 

ORBIT  NUMBER 

MONTH 

DAY 

NOT  USED 

YEAR (LAST  2 DIGITS) 

SPARE 

SPARE 

TAPE  ID(3  CHAR  ASCII  CODE; 

SBC  = UPDATE,  OBC  = DATA  BASE) 


TAPE  NO.  (6  DIGITS  IN  ASCII) 


BINARY 

CHANNELS  ACTIVE (0=N0T  ACTIVE, 
INACTIVE) 

sCURRENT  DATE  (BINARY) 


BINARY 


>DATE  OF  DATA  (BINARY) 


WORD 

NO. 


15 


HEADER  RECORD 
8 7 
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3.  Run  Time  and  Error  Messages.  Run  time  for  a typical 
job  is  approximately  5 minutes.  Error  messages  and 
their  causes  are  listed  below.  Any  of  these  error 
conditions  will  cause  program  termination,  and  when 
errors  are  corrected,  the  program  must  be  reinitiated 
to  continue. 

• TAPE  ID  DOES  NOT  MATCH  ID  = XXXX  (input  tape  is  not 
an  OBC  or  SBC  delog  tape) 

• UNABLE  TO  ALLOCATE  DISK  FILE  BY  NT RAN , STAT  = XXX 
(not  enough  free  disk  space  on  DK1) 

• UNABLE  TO  READ  RECORD  # , XXX  STAT  = XXX  (number 
requested  is  larger  than  the  last  record  on  tape 
for  the  file  requested) 

• UNABLE  TO  READ  DISK  RECORD  # XXX  STAT  = XXX  (number 
requested  is  larger  than  the  last  record  on  disk 
for  the  file  requested) 

• NT RAN  ERROR  STAT  = XXX  (input  tape  read  error  or 
data  transfer  error) 

• END  OF  DISK  FILE  (end  of  the  disk  file  was  reached 
. before  the  present  scan  line  was  processed) 

• CARD  INPUT  ERR:  START  PIXEL  # XXXX  IS  GREATER  THAN 

STOP  PIXEL  # XXXX  OF  SECTOR  # XXXX  (input  card 
error;  start  PIXEL  number  is  greater  than  the  stop 
PIXEL  number  of  indicated  sector  number). 

9,2,2  Flow  Charts.  See  following  77  pages. 
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APPENDIX  A 

UNIVERSAL  FORMAT  INFORMATION 


The  following  data  is  extracted  from  PHO-TR543,  Vol.  1,  Changes 
1-3,  dated  23  May  1973,  12  October  1973  and  22  March  1974,  re- 
spect L vely . 
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6,0,1  1MACERV  DATA  UNIVERSAL  FORMAT 
General  Ground  Rules 

o Tape  will  be  9-track,  800  BPI,  (or  5>b  BPI ) odd  parity  CCT  or  7-track* 

o 8 blta  ■ 1 byte 

o Basic  word  site  In  header  - 2 bytes 


o Word 

format  will  be  as  follows: 

MSB 

LSB 

Bit  No. 

12345678 

9 10  11  12  13  14  15  16 

^ MOST  SIGNIFICANT  > 

LEAST  SIGNIFICANT  a. 

BYTE 

' BYTE 

Binary  Data  la  right  Justified  In  the  field  defined. 
The  header  record  is  the  first  record  on  a tape. 


The  header  record  Is  fixed  length  equal  3060  bytes. 

Dots  following  the  header  will  be  arranged  by  data  sets,  where  a 
data  set  is  defined  as  the  ancillary  data  and  all  of  the  video  data 
for  one  scan  line  for  all  active  channels. 

Data  sets  will  be  recorded  in  variable  length  physical  records, 
not  to  exceed  3000  bytes  of  Information  per  record.  Note,  since 
3000  bytes  is  not  compatible  with  the  word  lengths  of  all  computers, 
the  computer  generating  the  tape  will  add  a sufficient  number  of  fill 
zeros  to  the  end  of  the  data  to  make  the  record  length  divisible  by 
32,  36,  48,  and  60  bits  (180  bytes).  Therefore,  It  is  possible  to  have 
a max  physical  record  length  of  3060  bytes,  but  under  no  condition 
will  data  exceed  3000  bytes. 

Data  sets  will  be  packed  into  consecutive  physical  records  of 
equal  length.  Under  no  condition  will  a data  set  begin  in  the 
middle  of  a physical  record  unless  the  data  set  can  be  completed 
In  that  record.  If  two  are  more  records  are  needed  for  the  data 
set,  the  data  set  will  be  divided  but  under  no  condition  will  the 
data  for  a video  channe 1 begin  in  the  middle  of  a physical  record 
unless  the  data  for  that  video  channel  can  be  completed  in  that 
record.  Consequently,  data  sets  which  are  lengthy  will  be  divided 
so  that  the  ancillary  block  and  video  data  from  an  integral  number 
of  channels  will  be  In  one  record  and  remaining  video  data  will 
follow  in  succeeding  records  with  an  integral  number  of  channels 
per  record.  Fill  zeros  will  be  supplied  at  the  ends  of  the  records 
as  required  to  satisfy  the  equal  length  constraint  notec  above. 


* The  universal  tape  format  was  designed  as  though  only  9-track  tapes  would  be 
written  and  read.  If  a 7-track  tape  output  is  required,  the  information  given 
In  the  universal  format  as  8-btt  bytes  is  translated  into  6-bit  characters. 

This  is  accomplished  by  converting  three  8-bit  storage  bytes  in  a serial  binary 
mode  into  four  6-bit  characters  and  writing  them  onto  the  7-track  tape  together 
with  parity. 


RI 

A]  A 

a|a 

0 

p 

0 

0 

0 

bTb 

0 

B 

B 

P 

0 

0 

c |c|c 

0 

c|c 
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6.0.1  IMAGERY  DATA  UNIVERSAL  FORMAT  (CONTINUED) 

Gtntnl  Ground  Rules  (Continued) 

o If  multiple  data  runs  are  on  the  same  tape,  the  runs  are  separated 

by  an  EOF.  Each  run  will  have  Its  own  header. 

o If  a run  Is  not  completed  on  a tape,  two  EOF's  are  written  on  the  tape 

and  a new  header  Is  then  written  on  the  next  tape. 

o When  a run  Is  completed  and  no  other  run  follows  on  that  tape 

three  EOF's  are  written. 

o All  data  In  the  header  record  and  ancillary  blocks  will  be  In  binary 

unless  otherwise  noted. 


o 


The  tape  format  will  be  as  follows: 


Header  Record 


IRC* 


Ancillary  Block 
Video  Block 


IRC** 


Ancillary  Block 
Video  Block 


IRC 


} 

} 


Data  Set 


Data  Set 


* IRC  " Inter  Record  Gap  - always  follows  the  header  record. 

a*  An  IRC  may  appear  between  the  ancillary  block  and  the  video 

block  so  that  the  recording  of  a data  set  requires  more  than 
one  physical  record;  or  a physical  record  mav  contain  two  or 
more  data  sets,  not  separated  by  any  IRC.  See  ground  rules 
above  and  data  set  description  following  for  criteria 
determining  the  placement  of  IRG's. 
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TABLE  6.0. 1-1  UNIVERSAL  FORMAT  IMAGERY  HEADER  RECORD 


BYTE  NO. 

DESCRIPTION 

NO.  OF  BYTES 

1-32 

Computing  System  ID  - EBCDIC 

Computing  System  producing 
this  tape,  i.e.,  ERIPS , 
PREPROC.,  PRODUCTION,  etc. 

32 

33-52 

Tape  Library  ID  - EBCDIC 

20 

53-60 

Sensor  ID  - EBCDIC 

S192 , MSS,  ERTS,  etc. 

8 

61-63 

Date  of  this  tape  generation 

Day  of  month  - Binary 

1 

Month  Number  - Binary 

1 

Year  - Last  2 digits  - Binary 

1 

64 

Tape  Sequence  ID  - Binary 
first  tape  reel  » 1 

1 

65-66 

Mission  No.  - Binary 

2 

67-68 

Site  - Binary 

2 

69 

Line  - Binary 

1 

70 

Run  - Binary 

1 

71-72 

Orbit  - Binary 

2 

73-80 

Time  of  first  scan  in  this  job 

Tenths  of  millisec  - Binary 
Seconds  - Binary 
Minutes  - Binary 
Hours  - Binary 
Day  of  month  - Binary 
Month  Number  - Binary 
Year  - Last  2 digits  - Binary 
Contents  of  these  bytes  should  remain  constant 
throughout  job. 

gl_88  Channels  active  in  this  job  - up  to 

64  channels,  1 BIT/CH  starting 
left  to  right  (MSB  to  LSB) , 

1 - active,  video  data  always 
appears  in  the  Ofder  indicated 
here . 
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TABLE  6. 

Header  Record 

BYTE  NO. 

89 

90 

91 

92-93 

94-95 

96-97 

98-99 

100-101 

102 


103 

104 

105-106 

107 

108-109 

110-111 


.1-1  UNIVERSAL  FORK\T  IMAGERY  HEADER  RECORD  (Continued) 
(Continued) 

DESCRIPTION  NO.  OF  BYTES 


Processing  flag  1 

0 - Raw  Data 

1 - Processed  data  from  computing 

system 

No.  of  channels  In  this  job  1 


No.  of  bits  In  a picture  element 

Byte  location  of  start 

of  video  data  within 
scan. 

Byte  location  of  start  of  first  cali- 
bration area  within  the  scan. 

No.  of  video  elements  per  scan 
within  a single  channel. 

No.  of  calibration  elements  in  the  first 
calibration  area  within  the  scan  in 
a single  channel. 

Physical  record  size  in  bytes 

This  number  must  be  a multiple  of  180  bytes. 

No.  of  channels  per  physical  record 

This  field  refers  to  the  second  and 
subsequent  records  within  the  record- 
ing of  a data  set.  Bytes  1785-1786  give 
the  number  of  channels  of  data  In  the 
first  record  of  a data  set. 
if  no.  elements  per  channel  greater 
than  3K  this  field  will  equal  0. 

No.  of  physical  records  per  scan 
per  channel.  This  field  Is 
used  only  when  the  no.  of 
elements  per  channel  is  greater 
than  3K.  Otherwise  it  Is  equal 
to  0. 

No.  of  records  to  make  a complete 
data  set. 

Length  of  ancillary  block  in  bytes 

Data  Order  Indicator 

0 - Video  ordered  by  channel. 

1 - Video  ordered  by  pixel 

Start  Pixel  No. 

Number  of  the  first  pixel  per  scan 
on  this  tape  referenced  to  original 
image.  The  first  pixel  in  the  original 
image  is  pixel  number  one. 

Stop  Pixel  No. 

Number  of  the  last  pixel  per  scan 
on  this  tape  referenced  to  original 
image. 


1 

2 

2 

2 

2 

2 

1 


1 


1 

2 

1 


2 


2 
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TABLE  6.0. 1-1  UNIVERSAL  FORMAT  IMAGERY  HEADER  RECORD  (Continued) 


BYTE.  NO*- 

DESCRIPTION 

NO.  OF  BYTES 

112-239 

A Coefficient  (2  bytes*  per  channel) 
o 

128 

240-367 

E Exponent  (2  bytes*  per  channel) 
o 

128 

368-495 

A ^ Coefficient  (2  bytes*  per  channel) 

128 

496-623 

E^  Exponent  (2  bytes*  per  channel) 

To  convert  parameter  value  (C)  to 
engineering  units  (Y) 

Y ■>  A * 10*°  + C * A.  10*’ 
o 1 

128 

624-687 

Color  Code  Information 

1 Byte /Channel  in  same  order  as 
'Channel  Active  on  this  Tape' 
Indicator. 

0 ■ Not  Active 

1 - Red 

2 - Green 

3 - Blue 

64 

688-751 

Scale  Factor 

l Byte/Channel  in  same  order  as 
'Channel  Active  on  this  Tape' 
Indicator. 

64 

752 

Offset  Constant 

1 

753 

Word  size  of  generating  computer 

Gives  size  of  smallest  quantity 
in  bits  that  machine  can  write 
on  tape. 

1 

754-1777 

Wavelength  of  Each  Channel 

8 Bytes  per  limit,  16  Bytes 

per  channel  EBCDIC  wavelength 

will  be  specified  in  mllli-microns . 

1024 

1778 

Number  of  Data  Sets  per  Physical  Record 

1 

1779-1780 

Address  of  start  of  second  calibration 
within  scan.  If  the  scan  has  only 
one  calibration  area,  this  field 
will  contain  zeros. 

2 

1781-1782 

Number  of  calibration  elements  in  the 

second  calibration  area  within  the 
scan  in  a single  channel.  If  the 
scan  has  only  one  calibration  area, 
this  field  will  contain,  zeros. 

2 

Calibration  source  indicator 

LSB  - second  calibration  area 
LSB  + 1 * first  calibration  area 

0 - low  calibration  source  data 

present 

1 - high  calibration  source  data 

present 


* Most  significant  bit  is  a sign  bit:  0 - 1 

Remaining  15  bits  are  straight  binary. 
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TABLE  6.0. l-l  UNIVERSAL  FORMAT  IMAGERY  HEADER  RECORD  (Continued) 


BYTE  NO. 

DESCRIPTION  N0^_ 

OF  BYTES 

1784 

1785-1786 

Fill  Zero 

Number  of  channels  In  the  first  physical 
record  of  the  diti 

1 

2 

1787-1788 

1789-1790 

Total  number  of  bytas  per  scan  par  channel  2 

Pixel  skip  factor  - the  quantity  to  be  added 

to  the  number  of  the  last  pixel  processed 
to  yield  the  number  of  the  next  pixel  to  e 
processed;  1 - process  every  pixel. 

2 - process  every  second  pixel, 

etc. 

1791-1792 

Scan  skip  factor  - the  quantity  to  be  added 

to  the  number  of  the  last  scan  processed 
to  yield  the  number  of  the  next  scan 
to  be  processed;  1 ■ process  every 
scan,  2 - process  the  second  scan,  etc. 

2 

1793-2940 

Caneral  Information 

Information  In  EBCDIC  generated  to 
satisfy  user  requirements.  Content 
will  be  unique  for  each  user  and  will 
depend  not  only  on  the  sensor  but 
also  on  the  specifications  of  the  user 
for  whom  the  tape  is  generated.  Bytes 
for  which  user  specifies  no  require- 
ment will  contain  fill  zeros. 

1793-2184 

Fill  zeros 

758 

2185-2550 

General  Annotation  byte  assignments  for 
ERIPS  (Not  Supplied  by  PDP) 

366 

2185-2484 

User  Comments 

300 

2485-2488 

Fill  zeros 

4 

2489-2496 

Latitude  of  pixel  1 of  registered  Image 

8 

2497-2504 

Longitude  of  line  1 of  registered  Image 

8 

2505-2512 

Latitude  scale  factor  - Deg/Plxel 

8 

2513-2520 

2521-2550 

Longitude  scale  factor  - Deg/Plxel 
Fill  zeros 

8 

30 

2551-26U2 

General  Annotation  byte  assignments  for 
CYBER  73  at  JSC. 

92 

26U3-2T58 

Fill  zeros. 

116 
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TABLE  6.0. l-l  UNIVERSAL  FORMAT  IMAGERY  HEADER  RECORD  (Continued) 


BYTE  HO. 


DESCRIPTION 


NO.  OF  BY  IKS 


2759-2940 


General  Annotation  Byte  Assignments  (or  tlie 
Production  Film  Converter 


2759* 

2760-2789* 

2790-2792* 

2793-2794* 

2795* 


2796* 

2797* 


n Thousand  scan  lines  per  frame  - Binary 
Job  ID  - EBCDIC 
Altitude  in  meters  - Binary 
Ground  speed  In  meters  per  second  - Binary 
can  Type  - Binary 

0 - Linear 

1 - Smoothed 

Angie  of  Arc  in  degrees  - Binary 
Camera  - Binary 


1 

30 

3 

2 

1 

1 

1 


2798* 


2799* 


2800-2807* 


0 “ 70  mu 

1 - 5-Inch 

Input  Device  - Binary 

0 - 9-TRK 

1 - HDT 

Truncation  - Binary 

0 ■ 2 LO  order  bits 

1 « 2 HI  order  bits 

2 - NO 

Channels  requested 

1 Bit/'Channel  up  to  64  total  channels  - Binary 


2808* 


Processing  Mode  - Binary 


1 


1 


8 

l 


0 ■ Serially 

1 - Concurrently 

2809-2873  Overlay  Image  Factors  - Binary 

Aq,  A^,  A2  . ..A^  Where  n » Channel  number  up 

to  64.  Ao  is  the  overall  factor.  There  is 
an  Implied  decimal  point  to  the  left  of  the 
lease  significant  decimal  digit;  if  the  MSB 
m. 1,  the  number  is  negative;  if  ■ 0,  positive. 

If  values  for  A are  not  provided,  the  default  value  of  A shall  be  1 when  processing 
color,  "1/n"  when  processing  gray  shade,  and  Aq  shall  be  "0"  for  both.  Then  the 
resultant  light  Intensity  for  pixel  P with  input  light  intensity  C for  channel  n is 

related  by; 

P • Ao  + (Aj  Cj  + Aj  Cj  + •••  + An  0n) . 


* Required  for  Image  Processing  Calculations. 
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TABLE  6.0. l-l  UNIVERSAL  FORMAT  IMAGERY  HEADER  RECORD  (Continued) 


BYTE  NO. 

DESCRIPTION 

NO.  OF  BYTES 

2759-2940 

General  Annotation  Byte  Assignment*  for  the 
Production  Film  Converter  (Continued) 

2874* 

Color  Select  - Binary 

0 - No  Color 

1 - Assigned  Color 

2 ■ False  Color 

1 

2875* 

Image  Format  - Binary 

0 - Single  Image 

1 - Overlay  Images 

2 - Abut  Images 

3 - Offset  Images 

1 

2876* 

Repeat  of  Pixels  per  Scan  - Binary 

0 - None 

1- 1  Repeat 

2- 2  Repeat 
n - n Repeat 

1 

2877 

Repeat  of  Scan  - Binary 

0 - None 

1- 1  Repeat 

2- 2  Repeat 
n - n Repeats 

1 

2878-2881 

Partial  Scan  - Binary 

Zeros  to  indicate  full  scan 

Byte  2878-2879  - From  Pixel  No. 
Byte  2880-2881  - To  Pixel  No. 

4 

2882-2883 

Sensor  scan  rate  in  scans/second  - Binary 

2 

2884 

Pixel  Size  - Binary 

1 

2885-2886 

Angle  of  Drift  - Binary 
Byte  2885  - ± Integer 
Byte  2886  - Fraction 

2 

2887-2940 

Fill  zeros 

54 

2941-3000 

ITITLE  - User  Designated  Identification 

60 

3001-3060 

Fill  Zeros,  makes  the  record  an  integral  number 
of  computer  words.  These  bytes  must  never 
contain  data. 

60 
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6.0. 1 1MACERY  DATA  UNIVERSAL  FORMAT  (Continued) 

Date  Set* 

o The  first  word  (2  bytes)  of  every  record  Is  a counter  Hiving  the  number  of  the 

physical  record  within  the  video  data  set.  This  Is  primarily  intended  for  use  in 
data  sets  that  are  greater  than  3000  bytes  long  and  therefore  require  more  tlun 
one  physical  record  for  recording.  This  word  will  always  equal  "l"  for  the  first 
record  of  a data  set. 

o The  first  block  of  a data  set  Is  the  ancillary  block. 

o The  length  of  the  ancillary  block  Is  variable,  with  the  number  of  bytes  given 

In  the  header  record. 

o Bytes  l through  4 of  the  ancillary  block  will  contain  the  current  CKT  at  the  start 
of  this  data  set  recorded  In  tenths  of  milliseconds. 

o Bytes  5 through  68  will  Indicate  channel  status  for  this  scan,  one  byte  per  channel, 
where  the  LSB  * 0 indicates  the  channel  In  sync,  and  the  LSB  * l Indicates  the 
channel  not  in  sync. 

o Bytes  69-70  contain  the  scan  line  number.  This  will  be  an  arbitrary  but  sequential 
count  for  each  scan  line  that  appears  in  the  data  run. 

o Bytes  71  through  N will  be  dependent  on  whether  this  Job  contains  raw  or  preoessed 
data.  (See  byte  89  In  the  header  record.)  The  value  of  N will  be  given  in  bytes 
105  and  106  in  the  header  record  and  will  always  be  equal  to  or  greater  than  70. 

o If  this  Job  contains  raw  data,  bytes  71  through  N will  contain  the  housekeeping 
data  channel  from  the  sensor,  if  one  Is  available. 

o A Job  containing  processed  data  will,  in  addition  to  the  70  bytes  of  ancillary  data 
already  described,  contain,  at  a minimum,  the  following  pieces  of  information: 

o Latitude  of  the  aircraft  or  of  the  center  of  the  image  from  EREP 
or  satellite  in  binary. 

o Longitude  of  the  aircraft  or  of  the  center  of  the  Image  from  EREP 
or  satellite  in  binary. 

o Altitude  In  meters  recorded  in  binary. 

o Heading  in  tenths  of  a degree. 

o Cround  speed  in  meters  per  second. 

o Roll  - Defined  in  specific  formats,  following. 

o Pitch  - Defined  in  specific  formats,  following. 

o Yaw  - Defined  in  specific  formats,  following. 

o Sun  angle. 


The  specific  formats  for  each  sensor  (following  In  this  section)  shall  provide 
where  this  data  will  appear  in  the  format. 
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6.0.1  IMAGERY  DATA  UNIVERSAL  FORMAT  (Continued) 

Data  Sets  (Continued) 

Other  parameter*  may  be  added.  If  required,  with  the  length  of  th# 
ancillary  block  given  In  the  header. 

o Following  the  ancillary  block  In  each  data  set  will  be  th*  video 

data  from  all  of  the  active  channels  for  one  scan.  The  video  data 
from  all  of  the  active  channels  for  one  scan  will  comprise  a video 
b lock . 

o Video  blocks  within  a data  run  will  always  contain  the  same  number 
of  video  channels. 

o Each  video  block  will  be  th*  same  number  of  bytes  in  length.  If 
video  data  is  not  available  to  fill  a block,  fill  *eroe  will  be 
added  to  make  it  the  same  length  as  preceding  video  blocks. 

o Video  data  less  than  8 bits  per  pixel  will  be  packed,  right 
justified,  in  an  8-blt  byte  with  teros  added  to  th*  left. 

o Video  data  greater  than  8 bits  per  pixel  will  be  packed,  right 
justified,  in  as  many  8-bit  bytes  as  necessary  to  hold  the 
pixel,  with  zeros  added  to  th*  left. 

o If  this  tape  contains  raw  data,  the  POI  sync  words  associated 
with  the  video  data,  if  any,  will  be  Included  with  the  video 
data  on  this  tape.  If  this  tape  contains  processed  data,  no 
sync  word*  will  be  present. 

o Calibration  data  that  is  associated  with  each  scan  within 
each  channel  will  be  included,  if  this  tape  contains  raw 
Imagery  data,  in  the  same  sequence  as  it  appears  in  the  data 
stream  on  the  flight  tape.  If  thla  tape  contains  processed 
Imagery  data,  the  appearance  of  the  calibration  data  will  depend 
on  the  specific  sensor  requirements  and  will  be  specified  in  the 
respective  format  following  in  this  documant. 

o The  combined  length  of  the  ancillary  block  and  the  video  block 
will  determine  the  relationship  between  data  sets  and  physical 
records.  Some  data  runs  may  contain  data  sets  which  are  so 
small  more  than  one  can  be  packed  into  one  physical  record. 

Others  may  contain  data  sets  which  will  require  a whole  physical 
record  for  each.  Still  others  may  contain  data  sets  which  are 
so  long  that  each  data  set  will  require  two  or  more  physical 
records . 

o Data  sets  will  be  packed  in  physical  records  depending  on  th* 

length  of  the  data  set.  The  ancillary  block  will  always  appear 
In  the  first  physical  record  per  data  set.  Following  the  ancillary 
block,  as  many  complete  channels  in  this  data  set  will  be  recorded 
as  will  fit  in  up  to  3000  bytes.  If  the  data  set  Is  too  long  to 
ba  recorded  in  on*  physical  record,  the  second  and  subsequent 
records  will  begin  with  the  next  active  channel  in  th*  data  set. 


o 


video  channel  will  not  be  divided  between  two  records  unless 
single  scan  from  that  channel  contains  more  than  3000  bytes, 
f a scan  from  any  channel  is  greater  than  3000  bytes  in  length, 
len  the  scan  will  be  divided  Into  as  many  equal  parts  as  Is 
ecessary  to  allow  each  part  to  equal  less  than  3000  bytes  and 
der*fo«,  fit  into  a physical  record  with  max  length  3000  bytee. 
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ft  n.l  IMAGERY  DATA  UNIVERSE  FOKMAT  (Ccntlnuejl 
Data  Sata  (Continued) 

it  m vi/icn  block  la  dlvldad  batwean  more  than  ona  racord  for 

° iictrdiJr  r^.“  *.»  <*«.».!.  i* n««  ..»«  ■«  *«* 

however  the  number  of  channels  In  all  records  following  the  fir 
a ll  ..r  uni  alwavs  ba  the  same.  The  number  of  channels  In 
thl  first  record  and  the  number  In  successive  records  will  be  Riven 
1^  the  header  racord.  In  records  following  the  first,  If  video 
data  is  not  available  so  as  to  allow  all  records  to  contain  the 
same  number  of  channels,  fill  zeros  will  be  added  In  lieu  of  the 
video  data  In  order  to  make  all  records  the  same  length.  l" * 
fUl  zeros  will  be  added  to  either  the  first  record  or  all  of  the 
successive  records,  depending  on  which  1.  shorter,  so  as  to  make  all 
of  the  records  the  same  length. 

o The  normal  arrangement  of  pixels  within  a scan  of  data  will 
be  by  channel.  The  Universal  format*  will  be  as  follows: 


CHANNEL  1 


CHANNEL  2 


LINE  1 


LINE  2 


CHANNEL  M 


CHANNEL  l 


l 

r 


CHANNEL  M 


PIXEL  1 

PIXEL  2 
o 
o 
o 

PIXEL  N 

PIXEL  1 

PIXEL  2 
o 
o 
o 

PIXEL  N 


PIXEL  l 
o 
o 
o 

PIXEL  N 

PIXEL  i 
o 
o 
o 

PIXEL  N 
o 
o 
o 

PIXEL  l 
o 
o 
o 

PIXEL  N 


data. 
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* If  this  tape  contains  raw  Imagery  data,  the 
If  any,  that  are  associated  with  the  data  on 
tape  will  be  included  with  the  data. 


PCM  sync  words , 
the  flight 
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